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I.   INTRODUCTION 


This  thesis  discusses  the  design  and  implementation  of 
a  high  level »  general  purpose  graphics  subroutine  library 
for  an  interactive  araphics  disDlav  system.  The  subroutine 
library  >was  designed  to  suDport  the  Vector  General  Interac- 
tive Display  System  (Vector  General)  [  1 1 #  as  installed  at 
the  Naval  Postgraduate  School  Computer  Laboratory. 

The  Vector  General  represents  a  highly  sophisticated 
graphics  display  terminal  with  hardware  implemented  three 
dimensional  rotation,  translation  and  scaling.  An 
alphanumeric  keyboard,  lighted  function  switches,  control 
dials  and  light  pen  provide  the  interactive  tools  of  the 
system.  The  Vector  General  is  interfaced  with  a  PDP-11/50 
computer  and  is  suooorted  by  the  UNIX  operating  system. 


The  actual  design  and  implementation  of  this  high 
level,  general  purpose  interface  is  discussed  as  well  as  the 
goals  and  problems  encountered  during  it's  development.  The 
problems  included  providing  a  user  with  the  ability  to 
describe  and  name  picture  seaments,  designing  functions  that 
would  not  limit  the  capabilities  of  the  machine,  and  how  to 
effectively  utilize  the  existing  interface  levels.  The  main 
goal  was  the  development  and  implementation  of  a  simple, 
easy  to  use,  general  purpose  graphics  subroutine  library. 


A  user's  manual  was  written,  describing  the  imolemented 
library  functions?  so  a  user  can  easily  utilize  the  qraphic 
capabilities  of  the  Vector  General  from  a  program  written  in 
the  high  level  language*  C  [?) .  This  is  included  as  Appen- 
dix A. 


II.   DESCRIPTION  OF  THE  VECTOR  GENERAL 


The  Vector  General  Graphics  Display  System  is  an 
interactive  graphic  cathode  ray  tube  (CRT)  display  that  is 
interfaced  with  a  PDP-11/50  computer.  The  display  interacts 
with  a  user  by  displaying  pictorial  data*  programmat i c 1 y 
described  by  the  user,  on  the  surface  of  the  CRT.  The  sys- 
tem provides  both  hardware  features  and  external  control 
devices  that  can  be  utilized  by  a  user  to  alter  and  manipu- 
late the  pictorial  data  being  displayed. 

A.   HARDWARE  FEATURES 


The  cathode  ray  tube  (CRT)  is  the  most  widely  used 
graphics  display  device  and  the  one  capable  of  generating 
and  dynamically  changing  graohical  data.  The  Vector  General 
display  consists  of  a  CRT  and  has  many  supporting  hardware 
features  (1*31.  The  hardware  features  provide*  in  addition 
to  a  vector  generator*  a  circle-arc  qenerator  and  a  charac- 
ter generator.  The  system  also  has  hardware  implemented 
three  dimensional  rotation*  translation  and  scaling.  The 
features  are  controlled  and  coordinated  by  the  Vector  Gen- 
eral display  controller.  The  controller  is  also  responsible 
for  handling  communications  with  the  external  control  dev- 
ices. These  external  devices  include  an  alphanumeric  key- 
board* thirty-two  lighted   function   switches*   ten   control 


dials*   and  a  light  pen.   Figure  1  is  a  block  diagram  of  the 
Vector  General  Display  System. 
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Vector  General  Display  System 
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III.   EXISTING  INTERFACE  LEVELS 


The  existing  interface  levels  for  the  Vector  General 
provide  an  efficient  interface  with  the  PDP-11/50  and  a  user 
software  interface  package  makes  the  detailed  operations  of 
the  system  transparent  to  the  user. 

A.   UNIX  AND  PDP-11/50  INTERFACE 

The  Vector  General  is  interfaced  with  a  PDP-11/50  com- 
puter having  64K  bytes  of  memory  and  up  to  sixteen  million 
bytes  of  disk  storage.  The  interface  was  designed  to  be 
used  in  the  mut 1 i orogrammi ng  environment  of  the  UNIX  time 
sharing  operating  system  [U]  . 

This  interface  provides  the  Vector  General  display  pro- 
cessor with  access  to  a  32K  block  of  PDP-11/50  memory.  The 
Vector  General  diSDlay  data  is  maintained  within  this  block, 
and  is  continually  accessed  through  a  Direct  Memory  Access 
(DMA)  channel  by  the  Vector  General  processor  in  order  to 
refresh  the  display  screen.  This  approach  frees  the  PDP- 
11/50  processor  for  other  tasks,  for  example  executing  user 
programs.  A  detailed  description  of  this  interface  design 
can  be  found  in  the  Design  Manual  for  the  Vector  General 
Di  sol  ay  Uni  t  [51  . 


11 


Perhaps  the  most  important  aspect  of  this  interface  is 
the  resulting  support  of  the  Vector  General  by  the  UNIX 
operating  system.  This  added  dimension  provides  the  graph- 
ics user  with  all  the  features  of  a  general -purpose*  multi- 
user* interactive  operating  system  in  addition  to  the 
graphic  capabilities  provided  by  the  Vector  General. 

The  UNIX  operating  system  is  designed  to  provide  a  user 
with  a  system  that  is  simple  and  easy  to  use  f^J .  Within 
this  framework  extremely  powerful  features  are  available  to 
the  user.  These  include:  a  hierarchical  file  system,  a  sys- 
tem command  language*  compatible  file-device  and  inter- 
process I/O*  over  100  subsystems  includina  several  languages 
and  the  ability  to  initiate  asynchronous  processes.  The 
system's  primary  high  level  languages  are  C  and  Fortran. 

These  features  of  the  UNIX  operating  system  provide  an 
efficient  and  flexible  environment  for  a  graphics  user.  The 
user  has  the  facilities  to  maintain  and  manipulate  large 
graphical  data  files.  Communications  links  with  devices 
such  as  tape  drives  and  disks  are  easily  established.  The 
command  language  provides  for  the  creation*  reading  and 
writing  of  files  and  for  transferring  them  between  devices. 
An  interactive  text  editor  is  available  for  program  crea- 
tion* as  is  an  interactive  debugger  for  program  debugging. 
These  are  only  a  few  of  the  extra  facilities  that  become 
part  of  the  graphic  users  environment  due  to  this  interface 
with  UNIX  and  the  PDP-11/50. 
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Moving  the  Vector  General  from  a  self  supporting  stand 
alone  graphics  environment*  to  one  supported  by  a  powerful 
operating  system,  greatly  extends  the  resources  available  to 
the  user.  This  extended  system  provides  an  environment  for 
the  development  of  a  truely  general  purpose*  high  level 
graphics  display  system. 

B.   LOWER  LEVEL  USER  INTERFACE 

The  existing  user  interface  software  package  defines 
high  level  constructs  which  the  interface  routines  convert 
to  Vector  General  commands.  These  constructs  define  a 
hierarchical  picture  structure  within  which  a  user  can  iden- 
tify meaningful  picture  segments.  The  three  construct  lev- 
els defined  by  the  softeware  interface  are:  picture,  object 
and  el ement  16] • 

1.   Picture  Structure 

The  construct  level,  picture,  refers  to  all  the  data 
that  is  to  be  displayed  on  the  Vector  General  display 
screen.  An  element  refers  to  the  smallest  picture  entity 
that  can  be  independently  referenced  and  changed  without 
affecting  the  remainder  of  the  picture.  Each  element  is 
defined  by  a  series  of  Vector  General  display  instructions. 
An  object  represents  the  lowest  construct  that  can  be 
displayed  alone.  Each  object  consists  of  one  or  more  user 
defined  elements.  An  object  is  i ndeoendent 1 y  rotatable, 
translatable   and   scalable   to   any   portion  of  the  display 
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screen.   The  picture  defines  the  oicture   scale   and   screen 
coordinates  for  all  objects. 

The  generation  and  contents  of  the  construct*  pic- 
ture and  object  are  the  responsibility  of  the  interface 
software.  A  series  of  user  routines  are  provided  for  the 
programmer  to  establish  the  desired  object*  element  associa- 
tions. Additional  routines  are  available  to  dynamically 
modify  picture*  object  and  element  parameters. 

These  three  constructs  orovide  a  logical  base  for 
structuring  of  pictorial  data  by  a  user.  It  does  not*  how- 
ever* produce  an  optimal  user  interface.  The  present  inter- 
face provides  no  assistance  in  the  creation  of  the  display 
instructions  that  describe  each  element.  The  user  is 
responsible  for  correctly  dimensioning  an  array  for  each 
element  and  for  filling  it  with  the  correct  Vector  General 
display  instructions.  These  instructions  reauire  the  user  to 
soecify  coordinate  values  with  respect  to  the  screen  coordi- 
nate system*  and  to  soecify  coordinate  registers  and  the 
desired  action(i.e.*  load*  draw  or  move).  This  process  of 
describing  elements  does  not  provide  a  user  with  a  clear* 
simple  and  unified  set  of  concepts  for  developing  graphic 
displays.  It  requires  the  user  to  concentrate  on  the  graph- 
ics device*  its  registers*  coordinate  system  and  capabili- 
ties and  not  on  the  picture  that  is  to  be  created.  The  pro- 
cess is  both  tedious  and  error-prone.  The  existing  interface 
does  not  provide  an  optimal  user  enviornment*  although  it 
does  offer  a  base  for  a  higher  level  user  interface. 
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2.   Display  List  Structure 

The  hierarchical  picture  structure  provided  by  the 
three  construct  levels  is  supported  by  the  implementation  of 
a  segmented  display  list  [51.  This  allows  for  the  dynamic 
modification  of  each  construct  level  which  is  a  necessity 
for  an  interactive  graphics  system  [71.  A  significant 
aspect  of  this  implementation  is  that  it  supports  the  con- 
cept of  shared  display  code.  This  is  analagous  to  a  conven- 
tional subroutine  call  which  allows  sections  of  code  to  be 
used  repeatedly.  Thus*  a  user  can  define  one  element  struc- 
ture and  by  associating  it  with  an  object  several  times? 
cause  the  element  to  appear  repeatedly  in  a  picture. 
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IV.   GENERAL  INTERFACE  DESIGN  CONCEPTS 


The  existing  user  interface  levels  supporting  the  Vec- 
tor General  and  the  environment  in  which  it  resides  has  been 
briefly  outlined.  The  present  system  does  not  provide  an 
adeguate  interface*  but  does  provide  the  base  for  the 
further  development  of  the  system.  The  environment  created 
by  the  UNIX  operating  system  also  supports  the  concept  of  a 
high  level  graphics  interface  for  the  Vector  General 
display.  The  tools  for  constructing  a  high  level  interface 
were  available*  the  decision  now  was  how  to  design  an  inter- 
face package  that  could  utilize  the  existing  environment  and 
provide  an  optimal  user  interface. 

A.   GRAPHICS  LANGUAGE  DESIGN 

In  designing  a  hiah  level  interface  the  main  considera- 
tion is  the  develoDment  of  a  hiah  level  graphics  programming 
language.  The  need  for  such  a  language  for  the  construction 
and  manipulation  of  graphical  data  cannot  be  overlooked. 
The  ease  with  which  a  system  can  be  programmed  is  a  major 
factor  in  determining  how  a  system  will  be  utilized  [83. 

A  graphics  language  must  provide  a  method  for  describing 
pictures  [9] .  The  language  must  have  facilities  for 
describing  not  only  non-geometric  entities  in  a  simple  form 
but  also  provide  a  way  to  describe  two  and  three  dimensional 
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geometric  entities.   Additional  facilities  should  be   avail- 
able for  scaling*  translation  and  rotation  [10] • 

Developement  of  a  high  level  language  that  provides 
these  features  can  be  approached  in  several  different  ways. 
A  set  of  graphic  functions  or  subroutines  can  be  developed 
to  be  used  by  an  applications  program,  written  in  a  high 
level  programming  language.  Another  approach  is  to  utilize 
the  high  level  language  of  the  host  computer  and  extend  it 
to  perform  a  variety  of  graphic  functions.  This  extension 
can  be  accomplished  by  changing  the  existing  compiler  to 
handle  graphics  functions  or  by  developing  a  preprocessor. 
If  a  suitable  high  level  language  is  not  available  on  a  sys- 
tem, then  the  development  of  a  language  specifically  for 
graphics  could  be  considered.  This  language  would  require 
not  only  the  development  of  graphic  functions  but  must  also 
provide  algorithmic-type  statements,  procedures  or 
subroutine  capabilities,  and  should  be  interactive  [9] . 

The  goal  for  the  Vector  General  was  the  development  of  a 
high  level  aeneral  purpose  language.  The  UNIX  operating 
system  provided  the  high  level  language  C,  that  has  facili- 
ties for  handling  many  different  data  types,  adequate  con- 
trol structures  and  data  structures  for  algorithm  represen- 
tation. It  also  provides  a  simple  subroutine  calling  format. 
Because  of  the  availability  of  the  high  level  languaae  the 
development  of  a  new  graphics  language  was  rejected.  The 
decision  was  to  either  incorporate  graphical  functions  into 
this    host    language   by   extending   the   language   or   by 
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developing  a  subroutine  library  package.  In  general » 
several  reasons  can  be  stated  for  not  selecting  the 
subroutine  library  approach.  These  include  the  lack  of  con- 
venience of  using  subroutine  calls  exclusively,  inefficient 
data  structures  provided  by  the  host  language*  and  lack  of 
facilities  in  the  host  language  to  support  a  wide  variety  of 
applications  (111.  The  C-language  provided  all  the  neces- 
sary facilities  and  convenience.  The  simplest*  and  most 
logical  approach  was  the  implementation  of  a  high  level 
subroutine  package  utilized  by  an  applications  program  writ- 
ten in  C . 

The  process  taken  in  developing  this  subroutine   library 
is  outlined  by  W.  M.  Newman  and  R.  F.  Sproull   [121  : 


1.  Select  a  suitable  language  on  which  to  base 
the  system. 

2.  Design  a  set  of  functions  for  graphical 
i  nput  and  outout . 

3.  Write  a  programmer's  manual. 

4.  Write  the  software*  to  perform  the  graphic 
f unct  i  ons . 


This  approach  was  taken  to  insure  the  development  of  a  user 
oriented  graphics  design  rather  than  one  that  was  merely 
easy  to  program  and  implement. 
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B.   CONSIDERATIONS  FOR  A  USER  ORIENTED  DESIGN 

One  of  the  goals  of  this  interactive  subroutine  library 
is  to  provide  a  general  purpose  high  level  package  that  will 
support  a  wide  variety  of  apol i cat i ons .  Addi t i onal 1 y ,  it  is 
important  that  the  system  be  user  oriented.  This  means  that 
the  resulting  graphics  orograms  should  be  as  easy  to  write 
and  maintain  as  any  other  interactive  oroqram.  The  design 
has  to  provide  a  clear  and  vivid  means  of  describing  the 
pictures  a  user  wants  to  create  [131. 

In  trying  to  produce  this  type  of  user  oriented  package 
several  reguirements  have  to  be  met  by  the  design  specifica- 
t  i  ons • 

1  •   Graphics  Primitives 

A  graphics  system  should  orovide  a  small  number  of 
powerful  graphics  primitives  [&) .  These  should  be  designed 
in  such  a  way  that  the  user  is  reguired  to  concentrate  on 
the  picture  being  described  rather  than  on  the  hardware 
features  of  the  machine.  The  user  must  be  able  to  construct 
logical  picture  segments*  combine  them  into  a  meaningful 
picture  and  then  manipulate  any  combination  of  these  picture 
segment  s  [13] • 

2,   Default  Parameters 

Default  parameters  should  be  skillfully  introduced 
into  the  system  18],  This  eliminates  a  novice  user  from  the 
irritating  details  of  the  system.    If   default   values  are 
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automatically  included/  a  novice  user  can  concentrate  on  the 
basic  problem  of  describing  a  picture. 

3.   Error  Diagnostics 

User  parameters  should  be  checked  and  all  errors 
should  provide  informative  diagnostics.  Errors  should  only 
activate  diagnostic  routines*  and  they  should  never  force 
the  termination  of  a  user  program  [10] •  A  user  should  be 
able  to  trace  and  correct  errors  with  a  minimum  of  effort. 
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V.   VECTOR  GENERAL  USER  INTERFACE  DESIGN 


The  design  of  the  Vector  General  high  level  interface 
is  implemented  in  the  form  of  subroutine  library  functions 
which  are  utilized  through  programs  written  in  the  high 
level  language  C.  Every  effort  was  made  to  limit  the  number 
of  functions  without  limiting  the  hardware  capabilities  of 
the  Vector  General.  The  design  of  this  primitive  set  is 
based  on  the  concept  of  picture  structure*  as  defined  by  the 
constructs  picture*  object  and  element. 

A.   PICTURE  STRUCTURE  AND  USER  ASSOCIATION 

The  present  interface  provides  the  capability  of 
describing  pictures  as  a  collection  of  objects  with  associ- 
ated elements  and  attributes.  The  framework  for  this  logi- 
cal description  of  a  picture  and  the  implementation  of  a 
structured  display  file  is  provided  by  the  existing  inter- 
face. This  is*  however*  inadequate  because  within  this 
framework  a  user  cannot  easily  generate  the  actual  display 
instructions  that  make  up  each  element.  Additional  capabil- 
ities for  easily  describing  a  logical  picture  element  and 
its  association  with  other  elements  and  with  the  picture  is 
provided  by  the  design  described  here. 
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The  implemented  design  introduces  the  concept  of  an  ele- 
ment block.  An  element  block  consists  of  a  series  of  move- 
draw  instructions  or  of  ASCII  character  data.  This  approach 
provides  a  flexible  way  for  clearly  isolating  and  naming 
specific  picture  segments.  Additionally  the  responsibility 
of  dimensioning  arrays  for  each  element  display  list  is 
removed  from  the  user  and  is  instead  managed  by  the  software 
interface.  This  dynamic  allocation  and  management  of  display 
lists  by  the  software  interface  greatly  extends  the  flexi- 
bility of  an  element  block.  Each  element  block  can  contain 
not  only  graphic  functions  but  any  of  the  C-language  arith- 
metic* conditional  or  logical  statements*  as  well  as 
subroutine  calls.  A  user  can  also  define  a  graphical  entity 
within  an  element  block  recursively. 

Many  problem  solutions  are  most  aooroor i at e 1 y  defined  in 
recursive  terms.  Wirth  sites  several  examoles  of  graDhic 
patterns  that  are  most  easily  described  by  a  recursive  algo- 
rithm [15]  •  The  caoability  of  defining  elements  by  recur- 
sive algorithms  provides  the  user  with  another  powerful 
tool  • 

In  addition  to  the  element  block  structuring*   a   primi- 

«. 

tive  is  provided  so  that  the  user  can  easily  establish  the 
desired  element*  object  relationships.  This  provides  an 
easy  and  concise  method  for  loaically  constructing  a  pic- 
ture. With  this  primitive  any  number  of  element  blocks  can 
be  associated  with  an  object  at  one  time  or  at  several  dif- 
ferent times  within  a  program. 
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B.   SELECTING   NON-LIMITING  PRIMITIVES 

The  Vector  General  provides  12  different  vector  types, 
arcs,  circles,  ASCII  characters  and  has  the  facilites  for 
creating  three  dimensional  images.  Incorporating  the  flexi- 
bility of  12  vector  types  and  two  or  three  dimensions  within 
a  limited  set  of  graphic  functions  presents  several  prob- 
lems. The  hardware  caoabilities  of  the  Vector  General  must 
be  available  to  a  high  level  user  in  a  concise  and  logical 
manner.  Extending  the  function  set  to  include  separate  func- 
tions for  each  vector  type  and  for  two  or  three  dimensions, 
is  not  appealing  because  it  provides  a  user  with  too  many 
opportunities  for  meaningless  and  erroneous  operations  [121. 
The  other  possibility  is  to  use  variable  length  parameter 
lists  for  a  small  function  set.  The  C-language  supports  the 
use  of  varible  length  parameter  lists  and  this  approach  is 
implemented  without  compromisina  other  factors  such  as  ease 
of  use,  simplicity,  and  understanding.  This  approach  lead 
to  the  development  of  nine  functions  which,  in  combination, 
allow  utilization  of  all  of  the  Vector  General  facilities  in 
creating  an  element  block  and  establish  the  desired  object, 
element  linking.  A  complete  description  of  these  functions 
can  be  found  in  Appendix  A. 
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C.   NAMING  CONVENTION 

The  constructs  object*  element  and  picture  provide  a 
multi-level  naming  structure  I14J.  This  structure  allows  a 
user  to  associate  integer  names  with  each  object  and  element 
that  is  created.  These  integer  names  are  assigned  values  by 
the  user  interface.  Additionally  each  element  is  also  asso- 
ciated with  an  array  name.  This  naming  convention,  which 
requires  user-interface  interaction  is  inadequate  for  a  high 
level  interface.  A  naming  convention  that  allows  a  user  to 
independently  assign  meaningful  names  to  objects  and  ele- 
ments is  reauired.  The  high  level  interface  design 
described  here  provides  a  simple  naming  process  which 
requires  a  user  to  specify  an  element  or  object  name  as  a 
quoted  character  string  within  a  parameter  list.  A  name  is 
associated  with  each  element  and  object  as  they  are  created 
by  the  user.  There  are  no  limitations  imposed  on  the  user 
in  assigning  names  exceot  that  each  name  must  be  unigue. 
Each  object  and  element  name  is  used  throughout  the  program 
to  reference  a  specific  picture  segment.  This  implementa- 
tion provides  a  flexible  and  easy  method  for  a  user  to  asso- 
ciate meaningful  names  with  each  object  and  element. 

The  existing  interface  supports  the  concept  of  shared 
display  code,  thus  allowing  for  the  repetition  of  an  element 
in  a  picture.  This  repetition  is  accomplished  by  associat- 
ing an  element  with  several  objects  or  with  one  object 
several  times.  This  latter  case  requires  that  a  user  be 
able   to   uniquely   reference   each  occurrence  of  an  element 
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within  a  specific  object.  The  naming  convention  had  to  be 
extended  to  handle  this  situation.  A  primitive  has  been 
designed  that  allows  a  user  to  assign  any  number  of  uniaue 
aliases  to  a  specific  element  block.  An  element  can  be 
associated  with  an  object  several  times,  each  association, 
however,  is  established  by  using  an  alias.  In  this  way  each 
occurrence  of  an  element  within  a  specific  object  can  be 
uniguely  referenced  by  its  alias. 

D,  ERROR  DIAGNOSTICS 

All  functions  and  user  routines  provide  error  checking 
and  diagnostic  information.  An  error  will  never  cause  the 
termination  of  the  user's  program.  Every  effort  is  made  to 
allow  a  user's  program  to  run  to  completion,  so  a  user  will 
receive  some  visual  feedback  from  the  Vector  General  display 
screen.  A  picture,  even  one  that  results  from  several 
errors  can  act  as  a  useful  debugging  aid  in  itself. 

E.  HIGH  LEVEL  USER  ROUTINES 

In  order  to  provide  a  comprehensive  graphics  package, 
the  naming  convention  and  picture  structure  concept  has  to 
be  applied  to  the  lower  level  user  routines  that  dynamically 
change  and  manipulate  picture  segments.  These  routines  are 
incorporated  into  this  high  level  structure.  When  possible 
several  low  level  routines  are  combined  to  provide  the  user 
with  a  simpler  and  vet  more  powerful  routine.  For  example, 
separate   routines  for  the  deletion  of  an  object  and  element 
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from  the  display  screen  are  provided  at  the  lower  level. 
These  two  routines  are  combined  into  one  routine  that  erases 
the  entire  picture*  an  object*  or  any  number  of  elements 
associated  with  a  specific  object.  Additionally*  a  routine 
is  included  so  a  user  can  not  only  erase  an  element  block 
but  also  free  up  the  memory  locations  associated  with  the 
element  block.     / 

The  advantages  of  allowing  a  user  to  manipulate  display 
list  storage  lies  in  the  fact  that  it  is  extremely  difficult 
for  the  software  interface  to  determine  which  display  list 
structures  are  no  longer  reauired  and  should  be  removed. 
The  user  on  the  other  hand  knows  precisely  when  a  specific 
item  is  no  longer  needed  [161.  The  system  makes  available  a 
finite  area  for  the  creation  of  display  lists.  Erasing  an 
element  does  not  release  memory.  Elements  still  exist  and 
can  be  reassociated  with  the  oicture  at  anytime.  The  user 
should  have  the  ability  to  optimize  this  storage  area*  by 
releasing  elements  that  are  no  longer  reguired.  This  is 
particularly  important  when  a  user  program  exceeds  the  allo- 
cated display  list  storage.  Only  by  selectively  removing 
elements  from  memory  and  releasing  the  related  memory  loca- 
tions can  new  elements  be  created.  A  user  can  extend  the 
systems  storage  limitations  by  efficiently  managing  the 
display  list  storage  area. 
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VI.   RECOMMENDATIONS 


The  implemented  graphics  subroutine  library  provides  a 
general  purpose  interactive  graphics  package.  The  routines 
provided  for  using  the  external  display  control  devices  are 
adeguate*  but  can  be  extended  to  provide  a  simpler  package 
for  a  user.  For  examoler  the  routines  that  control  the 
function  switches  and  the  function  switch  lamps  could  be 
combined  to  provide  a  simpler  interface.  A  varietv  of 
routines  for  utilizing  the  light  Den  should  be  available  to 
a  user.  For  example*  a  light  pen  trackina  routine  would  ben- 
ifit  the  system. 
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VII.   CONCLUSION 


The  high  level  general  purpose  graphics  subroutine 
library  discussed  in  this  thesis  is  operational.  Initial 
test  programs  indicate  that  the  system  does  provide  a  sim- 
ple* but  powerful  approach  for  the  development  of  interac- 
tive graphics  programs. 
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APPENDIX  A:  USER  REFERENCE  MANUAL 
I.  INTRODUCTION 

The  vector  general  is  an  interactive  graphics  display 
system  which  has  been  interfaced  with  the  PDP-11/S0  comput- 
er. The  display  interacts  with  a  PDP-11  user  by  displaying 
pictorial  information  on  the  surface  of  a  cathode  ray  tube 
and  by  accepting  information  from  its  external  control  dev- 
ices. The  external  devices  consist  of  an  alphanumeric  key- 
board* 32  lighted  function  switches*  10  control  dials*  and  a 
light  pen.  Through  a  C-callable  interactive  graphics  program 
library*  the  pictorial  information  desired  by  a  user  can  dp 
described*  altered  and  manipulated.  This  manual  will  not 
discuss  in  detail  the  electronic  functions  of  the  vector 
general*  or  the  vector  general's  interface  with  the  PDP-11. 
The  purpose  of  this  manual  is  to  instruct  a  user  in  the 
creation  and  manipulation  of  pictorial  data  on  the  vector 
genera  1  display. 

This  manual  describes  the  use  of  a  C-callable  interac- 
tive graphics  program  library.  A  knowledge  of  the  C- 
programming  language  is  assumed.  The  user  is  also  directed 
to  Appendix  B  for  a  brief  description*  calling  format  and 
error  diagonistic  information  on  each  of  the  user  interface 
rout  i  nes . 
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II.  THE  VECTOR  GENERAL  DISPLAY  SYSTEM 

A  more  detailed  discussion  of  the  vector  general  can   be 

found   in   the   Users   Manual  for  the  Vector  General  Display 

Unit  tbl  and   the   Design   Manual   for   the   Vector  General 
Di  splay  Uni  t  C51 . 

A.   THE  DISPLAY 


The  vector  general  is  a  cathode  ray  tube  (CRT)  display 
on  which  a  visible  pattern  can  be  created  by  the  movement  of 
an  electron  beam.  The  electron  beam  causes  a  florescent 
spot  to  appear  on  the  face  of  the  display  tube.  The  move- 
ment of  the  beam  is  controlled  by  a  method  called  random 
scan*  which  in  effect  steers  the  soot  in  a  straiaht  line 
between  two  points  on  the  display  screen.  The  resulting 
line  or  vector,  combined  with  others*  creates  a  Dicture  or 
pattern  on  the  display  screen. 

To  maintain  a  clear  picture  on  the  display  screen  re- 
guires  that  the  pattern  be  redrawn  on  the  tube  repeatedly  at 
approximately  thirty  to  forty  times  a  second.  Each  repeti- 
t i on  is  called  a  frame  and  the  frequency  at  which  it  is 
redrawn  is  called  the  refresh  rate.  If  the  pattern  is  not 
repeated  often  enough,  or  more  information  than  can  be 
redrawn  in  a  frame  is  displayed,  a  distortion  of  the  picture 
will  occur  on  the  display  screen.  This  distortion  is  called 
f 1 i  cker • 
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B.  HARDWARE  FEATURES 

The  system  has  several  hardware  features*  in  addition  to 
a  vector  generator*  which  greatly  extends  its  capabilites. 
These  include*  the  ability  to  produce  three  dimensional  fig- 
ures* an  ASCII  character  set*  and  the  hardware  generation  of 
arcs  and  circles.  Other  features  provide  the  hardware 
mechanisms  for  the  rotation  and  translation  of  user  speci- 
fied picture  segments.  These  hardware  features  are  con- 
trolled and  coordinated  by  the  display  controller.  The  con- 
troller is  responsible  for  handling  the  communications 
between  the  user  interface*  the  external  control  devices  and 
the  display  hardware. 

The  main  Durpose  of  the  external  control  devices  is  to 
facilitate  user  interaction  with  the  display.  These  devices 
include  an  alphanumeric  keyboard*  32  lighted  function 
switches*  10  control  dials  and  a  light  pen. 

Additional  information  on  the  vector  general  hardware 
can  be  found  in  the  Graphics  Display  Reference  Manual  [11 
and  the  Graphics  Display  System  Technical  Manual  [3]. 

C.  THE  SYSTEM  INTERFACE 

A  vector  general  user  defines  pictorial  data  and  its 
manipulation  within  a  C-language  program.  The  execution  of 
the  program,  on  the  PDP-11/50*  causes  the  vector  general 
software  interface  to  be  activated.    It   is   this   software 


31 


interface  package*  which  communicates  user  requests  and 
receives  information  from  the  vector  qeneral  controller.  The 
interface  package  passes  user  requests*  in  the  prooer  form* 
to  the  diplay  controller.  The  controller  will  activate  the 
proper  generator  (ie.  character*  vector*  arc/circle)  which 
will  output  the  desired  information*  requested  by  the  user* 
on  the  diolav  screen.  The  controller  will  also  nass  infor- 
mation from  the  external  control  devices  back  to  the  user 
via  the  interface  software.  This  relationship  is  illustrated 
in  f  i  qure  A-l . 
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D.   INTERFACE  WITH  EXTERNAL  DEVICES 


Each  of  the  the  external  interactive  devices  communicate 
directly  to  the  vector  general  controller.  Information  from 
these  devices  is  returned  to  the  user  via  the  controller  and 
the  user  interface.' The  user  program  may  utilize  the  infor- 
mation returned  from  these  devices  to  control  program  flow. 
This  allows  a  user  to  interactively  control  and  manipulate 
the  pictorial  information  at  display  time.  Specific  user 
routines  which  activate  these  external  devices  and  provide  a 
communications  channel  with  the  user  are  discussed  in  detail 
in  later  sections  of  this  manual. 

1.  Alphanumeric  Keyboard 

The  alphanumeric  keyboard  allows  the  user  to  input 
information  in  the  form  of  ASCII  character  codes.  Through 
the  user  interface  the  user  can  disolay  the  information  on 
the  vector  general  disolay  screen.  The  data  entered  from 
the  keyboard  can  also  be  returned  to  the  user  program  for 
process  i  ng. 

2.  Function  Switches 

The  32  lighted  function  switches  provide  the  user 
with  information  which  can  be  used  to  interactively  manipu- 
late pictorial  data  at  disday  time.  Each  function  switch 
can  be  assigned  specific  meanina  by  the  user  program.  The 
user  interface  returns,  from  the  controller  to  the  user, 
information  on  which  function  switches  have  been  pressed.  A 
user   program   could   use   this   information   to  selectively 
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rotate*  translate  op  perhaos  scale  particular   picture   seg- 
ment s  • 

3.  Cont  ro 1  Dials 

The  10  control  dials  provide  numeric  information  to 
the  display  controller*  specifying  the  degree  to  which  each 
dial  has  been  turned.  This  information,  through  the  user 
interface*  can  be  provided  to  the  user.  A  user  orogram  mav 
utilize  the  values  of  the  variable  control  dials  in  deter- 
mining the  distance  or  rate  at  which  a  oortion  of  the  pic- 
ture may  be  moved  or  rotated. 

4.  Light  Pen 

The  light  pen*  a  wand  containing  a  photo  cell*  can 
be  used  to  selectively  point  to  different  picture  segments 
on  the  disolay  screen.  The  interface  provides  a  user  pro- 
gram with  information  on  which  Dicture  segment  was  pointed 
to  by  the  light  oen.  A  user  program  can  turn  the  light  oen 
sel ec t ab i 1 i t y  of  soecific  picture  segments  on  or  off.  For 
example*  an  interactive  user  might  select  sections  of  a  pic- 
ture for  erasure  by  pointing  to  them  with  the  light  pen. 


III. 


INITIALIZATION 


A.   INTERFACE  INITIALIZATION 


The  vector  general  display  system  and  the  interface 
software  with  the  PDP-11  must  be  initialized  before  any  data 
can   be   displayed.   The  initialization  routine  sysinit  must 
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be  called  before  any  other  routines  are  utilized.  This 
routine  sets  all  the  system  default  parameters,  such  as  the 
screen  coordinate  system. 

If  for  some  reason  the  initialization  cannot  be  complet- 
ed the  user  program  will  be  terminated.  This  error  usually 
occurs  because  another  user  is  accessing  the  vector  general. 

B.   DISPLAY  INITIALIZATION 

1.   Coordinate  System 

The  user  can  specify  a  two  or  three  dimensional 
cartesian  coordinate  system,  of  any  scale.  All  display  coor- 
dinate values  referenced  by  the  user  will  be  interpreted 
according  to  this  coordinate  system  definition.  A  user  may 
redefine  the  coordinate  scale  at  any  time  in  a  program.  The 
user  will  define  the  coordinate  system  in  a  call  to  the 
routine  coordsys. 

coordsys(dim,minx,maxx,miny,maxy  t,minz,maxzJ  ); 


The  routine  requires  the  user  to  specify  if  the  coordi- 
nate system  is  to  be  two  or  three  dimensional  and  the  range 
of  each  coordinate.  If  the  parameter  dim  is  two,  indicating 
a  two  dimensional  coordinate  system  is  desired,  the  range  of 
the  z  coordinate  can  be  omitted,  and  will  be  ignored  if  it 
should  be  included. 

If  this  routine  is  not  called  by  the  user  the  default 
coordinate   system   will   be   used.    This  default  system  is 
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defined  as  three  dimensional  with  the  x,  y,  z  coordinates 
ranging  from  -100.0  to  100.0.  All  coordinate  values  will  be 
interpreted  by  this  default  system  when  coordsys  is  not 
cal 1 ed  by  the  user . 

2.   Pi  cture  Seal e 

The  rectangular,  13  by  14  inch*  portion  of  the 
display  screen  that  can  be  viewed  by  the  user  is  called  the 
visible  space.  The  maximum  picture  soace  is  larger  than  the 
visible  space*  covering  an  area  of  30  by  30  inches.  This 
extra  area  allows  a  user  to  rotate  or  move  part  of  the  pic- 
ture to  the  extreme  boundries  of  the  visible  space  without 
any  distortion.  It  also  oermits  limited  zooming. 

The  pictorial  data  beinq  displayed  can  be  adjusted  in 
size*  or  scaled,  by  two  different  controls.  One;  the  gain 
control  dials  on  the  vector  general  display  unit  allow  the 
user  to  manually  manipulate  the  Dicture  scale.  The  second 
provides  scale  control  within  the  user's  program  by  calling 
the  routine  vgpscal.  This  routine  is  discussed  in  detail  in 
Section  V  of  this  manual. 

IV.  CREATING  A  PICTURE 

A.   PICTURE  STRUCTURE 

All  of  the  information  that  a  user  desires  to  display  on 
the   vector   general    must    be    incorporated    into    the 
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hierarchical  picture  structure  defined  by  the  user  interface 
package.  The  three  hierarchical  levels  are  defined  as:  pic- 
turer  object*  element.  These  levels  specify  the  underlying 
structure  of  the  graphical  display  and  determine  the  opera- 
tions a  user  can  perform  on  information  associated  with 
each  1 evel  . 

The  term  picture  refers  to  all  of  the  data  that  is  to  be 
displayed  on  the  vector  general  display  space.  The  term 
element  refers  to  the  smallest  picture  segment  which  can  be 
independently  referenced  and  changed  without  affecting  the 
remainder  of  the  oicture.  Each  element*  or  independent  pic- 
ture segment*  has  a  uniaue  name  associated  with  it.  A  col- 
lection* or  meaningfull  grouping*  of  elements  is  called  an 
object.  Each  object  is  also  labeled  by  a  unigue  name  so  it 
can  be  easily  referenced  by  a  user.  Figure  A-2  illustrates 
the  relationship  of  the  three  levels  in  the  actual  structure 
of  a  oicture. 

An  element  is  completly  described  and  named  by  the  user. 
It  can  describe  either  graphical  or  ASCII  character  data. 
An  element  can  be  independently  added  or  erased  from  the 
display  screen.  It  can  be  caused  to  blink  or  be  specified 
as  being  light  oen  selectable. 

Each  element  must  be  associated  with  at  least  one  object 
before  it  can  be  displayed  on  the  vector  general.  An  object 
can  consist  of  one  or  more  elements.  A  user  is  reponsible 
for  establishing  the  desired  ob j ec t -e 1 ement  association, 
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Hierarchical  Picture  Structure 
FIGURE  A-2 
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and  for  specifying  a  unique  name  for  each  object.  Each  user 
defined  object  can  be  independently  rotated,  or  translated 
to  any  section  of  the  30  by  30  inch  display  space.  An  ob- 
ject can  be  added  or  erased  from  a  picture,  scaled,  and 
specified  to  blink  or  to  be  light  pen  selectable.  Each 
object's  intensity  can  be  varied  in  order  to  give  three 
dimensional  objects  their  depth  queuing.  These  actions,  when 
applied  to  a  specific  object,  affect  every  element  that  has 
been  associated  with  it  bv  the  user. 

A  picture  can  contain  one  or  more  objects.  The  coordi- 
nate scale  and  picture  scale  defined  by  the  user  affects  the 
entire  picture.  A  picture's  coordinate  scale  can  be  varied 
but  this  action  will  affect  every  object  defined  as  part  of 
the  picture.  An  entire  picture  can  also  be  erased,  speci- 
fied to  blink  or  be  light  pen  selectable. 

A  summary  of  the  operations  for  each  level  of  the 
hierarchy  is  outlined  in  Figure  A-3. 

B.   CONSTRUCTING  AN  ELEMENT 


Every  element  is  completely  described  by  the  user  within 
an  element  block.  There  are  two  types  of  element  blocks.  A 
draw  element  block,  describes  graphical  information.  The 
other,  a  character  element,  describes  ASCII  characters  that 
are  to  be  displayed.  Each  element  is  uniquely  named  and 
this  name  will  be  used  to  reference  this  particular  struc- 
ture. 
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Summary  Operations  Associated  with  Each  Hierarchial  Level 

FIGURE  A-3 
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1.   Draw  Element  Block 

A  draw  element  block  represents  a  group  of  draw 
instructions  that  describe  a  specific  structure*  or  picture 
segment.  These  draw  instructions  include  setvector,  mover 
liner  arc  and  circle.  A  draw  element  block  beains  with  a 
call  to  the  routine  drawele  and  is  terminated  by  a  call  to 
the  routine  endele.  The  draw  instructions  that  are  executed 
between  drawele  and  endele  describe  the  actual  picture  seg- 
ment . 

The  only  parameter  required  by  drawele  is  a  quoted  char- 
acter string/  or  pointer  to  a  character  string,  specifying 
the  name  the  user  wants  to  associate  with  this  element. 
This  name  will  be  used  throughout  the  program  to  reference 
this  el ement  bl oc  k . 

The  basic  draw  element  block,  and  the  related  draw  in- 
structions are  reoresented  in  the  following  format: 


--  drawe 1 e ( "el ement -name" ) ; 

setvectorCvtypervmode,  fine) #  [scale! )  J 


---setvectorCvtypervmode,  Unci r  [sea  1  el  ); 

move ( x  t   C y 1 ,  Iz)  )  ? 

1 ine(x, tvl ,  lz) ); 

circleCdirrcentxr  fcentyl  ,   [centzl  ); 
---  arc (di r, cent x ,  (centvl  t   [centzl  rendx,  [endyJ  *  lendzl  )? 


---  ende 1 e ( ) ; 


The   user   can   select   one  or  more  of  the  twelve  vector 
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types  in  constructing  an  element.  These  vector  types 
describe  how  the  coordinate  data  will  be  interpreted  in 
drawing  a  vector  on  the  display  screen.  The  choice  of  a  vec- 
tor effects  the  parameters  that  will  be  passed  in  each  of 
the  move*  line/  circle  or  arc  instructions.  The  user  soeci- 
fies  a  vector  selection  by  callina  the  routine  setvector. 

a.  setvector  -  This  draw  instruction  must  be  called 
immediately  after  drawele/  and  may  be  called  any  number  of 
times  within  the  element  block.  Each  setvector*  and  the  draw 
instructions  that  follow  it*  comorise  a  subgroup.  The  set- 
vector  instruction  determines  the  manner  in  which  the  line* 
move/  arc  and  circle  instructions  in  the  subgroup  will  be 
interpreted/  as  well  as  their  visual  appearance  on  the 
display  screen.  The  routine  is  called  with  the  following 
parameters : 

set  vector ( vt yoe» vmode  [»incl  [/scale))? 

The  parameter  vtype  specifies  which  one  of  the  twelve 
vector  tvpes  the  user  wants  the  following  group  of  line/ 
move/  arc  and  circle  instructions  to  utilize.  The  parameter 
vmode  indicates  the  vector  mode/  or  appearance  of  the  vec- 
tors to  be  drawn  (ie/  solid  line/  dotted  line/  etc.).  Cer- 
tain vector  types  require  additional  information/  this  in- 
formation is  specified  by  the  parameters  i nc  and  scale. 
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TABLE  A-I 
SUMARY  OF  VECTOR  TYPES 


NAME  DESCRIPTION 

VA   -  vector  absolute,  each  coordinate  is  specified 
with  respect  to  the  origin.   Each  point(x,y,z) 
references  a  unique  point  on  the  display  screen. 

VAX  -  vector  absolute  auto-increment  x,  every  draw 
instruction  causes  the  y  and  z  absolute 
values  to  be  updated  while  x  is  steeped  by  a 
const  ant  value. 

VAY  -  vector  absolute  auto-increment  y,    every  draw 
instruction  causes  the  x  and  z  absolute 
values  to  be  updated  while  y  is  stepped  by  a 
constant  val ue. 

VAZ  -  vector  absolute  auto-increment  Zr    every  draw 
instruction  causes  the  x  and  y  absolute 
values  to  be  updated  while  z  is  stepped  by  a 
constant  value. 

VR   -  vector  relative*  each  x,  y,     z  coordinate 
value  indicates  the  amount  that  is  to  be 
added  or  subtracted  from  the  previous  absolute 
coordi  nat e  poi  nt  . 

VRX  -  vector  relative  aut o- i nc rement  x,  each  draw 

instruction  causes  the  y  and  z  coordinate  values 
to  be  incremented  by  the  specified  value  while 
x  is  stepped  by  a  constant  value. 

VRY  -  vector  relative  auto-increment  yr    each  draw 

instruction  causes  the  x  and  z  coordinate  values 
to  be  incremented  by  the  specified  value  while 
y  is  stepped  by  a  constant  value. 

VRZ  -  vector  relative  auto-increment  z,  each  draw 

instruction  causes  the  x  and  v  coordinate  values 
to  be  incremented  by  the  specified  value  while 
z  is  stepped  by  a  constant  value. 
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TABLE  A-T 
(cont i  nued) 


INC2-  two  dimensional  incremental  vector/  a 

relative  vector  that  optimizes  storage  re- 
quirements.  The  coordinate  increment  values 
are  limited  to  values  aoprox i matel y  3%  of  the 
user's  coordinate  range. 

INCX-  two  dimensional  incremental  auto-increment  x* 
is  a  relative  vector  that  oDtimizes  storage 
requirements.  The  y  coordinate  value  is 
incremented  by  a  small  value  while 
x  is  stepped  by  a  constant  value. 

INCY-  two  dimensional  incremental  auto-increment  y» 
is  a  relative  vector  that  ODtimizes  storage 
requirements.  The  x  coordinate  value  is 
incremented  by  a  small  value  while 
y  is  stepoed  by  a  constant  value. 

INC3-  three  dimensional  incremental  vector,  a 

relative  vector  that  optimizes  storage  re- 
quirements. The  x/  Vf  z  coordinate  increment  values 
are  limited  to  values  that  are  approximately  3% 
of  the  user's  coordinate  range. 
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A  brief  summary  of  the  twelve  vector  types  is  listed  in 
Table  A-I,  a  more  detailed  account  of  each  vector  type  and 
the  parameters  required  by  setvector  are  listed  in  Aopendix 
B.  Figure  A-4  illustrates  the  five  different  vector  modes 
that  are  avai 1 abl e. 


VECTOR  MODE 


PARAMETFR  VALUE 


VISUAL  APPERANCE 


1  i  ne 

dashed 
dot  ted  line 
end  point 
dash-dot -dash 
dash-dot -dash 


LN   /  00 
DSH  /  020 
DOT  /  oao 
PNT  /  060 

00  /  0120 
000  /  oiao 


Vector  Modes 
FIGURE  A-a 

b,  move  -  The  draw  instruction  move  is  used  to 
reposition  the  beam  on  the  display  screen.  It  will  produce 
no  visible  line  or  pattern.  The  format  of  the  instruction 
is: 

move  (  x  [ t y]   [ , zl  ) ; 


The  coordinate  values  x,  y,     z  will   be   either   absolute   or 
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relative  values.  The  vector  type  selected  in  the  proceed- 
ing setvector  instruction  will  determine  how  the  value  of 
these  parameters  will  be  interpreted.  The  bracketed  values 
indicate  parameters  that  may  be  ootional. 

If  the  user  coordinate  system  is  not  three  dimensional, 
the  z  parameter  can  be  omitteo,  ana  will  be  ignorea  if  it 
should  be  i  r  eluded. 

c.  line  -  The  line  instruction/  draws  a  visible 
line  or  vector  on  the  display  screen.  The  line  is  drawn 
from  the  present  beam  locaton  to  the  specified  end  point. 
The  format  of  the  instruction  is: 

lineCx  Uvl   (,  z)  )  ? 

The  coordinate  values  x,  y,  z  will  be  either  absolute  or 
relative  values.  The  vector  type  selected  in  the  previous 
setvector  determines  how  the  value  of  these  parameters  will 
be  i  nterDreted. 

If  the  user  has  defined  a  two  dimensional  coordinate 
system,  the  z  parameter  can  be  omitted,  and  will  be  ignored 
if  it  should  be  included. 

d.  circle  -  The  circle  instruction  will  draw  a  cir- 
cle beginning  at  the  present  beam  location  about  the  center 
point  soecified  by  the  user.  The  difference  between  the 
present  beam  location  and  the  center  point  determines  the 
radius  of  the  circle.  The  instruction  is  used  by  the  fol- 
lowing format: 


at 


c i re  1 e (di r / cent x  C/centy]  l/centzl); 

The  parameter  dir  indicates  in  which  direction  the  cir- 
cle is  to  be  drawn,  clockwise  or  counterclockwise.  The 
number  of  parameters  required  and  their  values  are  deter- 
mined by  the  vector  type  selected  in  the  previous  setvector 
instruction.  A  circle  cannot  be  drawn  by  any  of  the  four 
incremental  vectors. 

If  the  user  coordinate  system  is  two  dimensional/  the  z 
parameter  can  be  omitted/  and  will  be  ignored  if  included. 

e.  arc  -  The  arc  instruction  will  draw  an  arc  from 
the  present  beam  location/  about  the  specified  center  point/ 
to  the  desired  end  point.  The  distance  between  the  starting 
point  and  the  center  point  determines  the  radius  of  the  arc 
being  drawn.   The  instruction  format  is  : 

arc  (di  r  /  cent  x     t/centvl      [  /  cent zl  / endx     (,endyl      Cendzl)/ 


The  oarameter  dir/  gives  the  direction  the  arc  is  to  be 
drawn/  clockwise  or  counterclockwise.  The  coordinate  values 
are  determined  by  the  vector  tyoe  selected  in  the  previous 
call  to  setvector.  An  arc  cannot  be  drawn  by  any  of  the  four 
incremental  vectors. 

If  the  user  coordinate  system  has  been  defined  as  two 
dimensional/  the  z  parameters  can  be  omitted/  and  will  be 
ignored  if  included. 

If  the  distance  from  the  starting  point  of  the  arc  to 
the  center  point/  and  the  distance  from  the  end  point  to  the 
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center  point  are  not  equal,  the  resulting  arc  will  contain  a 
straight  line.  The  straight  line  results  from  the  arc  gen- 
erator trying  to  compensate  for  the  two  different  distances 
to  the  center  point.  One  distance  will  be  used  to  determine 
the  radius  of  the  arc*  the  arc  will  then  be  drawn  using  this 
radius.  The  arc  will  stop  at  the  systems  new  defined  end 
point  and  a  straight  line  will  be  drawn  to  the  end  point 
that  had  been  specified  by  the  user.  The  resulting  arc  ap- 
pears in  the  following  form: 


2.   Character  Element 

A  character  element  represents  ASCII  character  data  that 
is  to  be  incorporated  into  the  oicture  structure.  A  user  can 
specify  a  character  element  containina  ASCII*  special  vector 
general  characters  and  formatting  symbols  to  be  displayed  on 
the  vector  general  display  screen.  A  user  can  select  from 
four  character  sizes  and  has  the  option  of  selecting  a 
slanted  character  set.  The  text  can  be  displayed  horizon- 
tally or  vertically  on  the  screen.  The  vertical  position 
causes  the  characters  to  appear  as  if  they  were  on  a  page 
that  had  been  rotated  ninety  dearees  counter  clockwise.  The 
user  can  select  the  position  on  the  screen  where  the  string 
is  to  begin*  or  can  output  it  relative  to  the   present   beam 


UQ 


pos  i  t  i  on. 

Each  character  element  is  given  a  unique  name  by  the 
user.  This  name  will  allow  the  user  to  easily  reference 
each  character  element.  A  character  element  is  represented 
by  the  following  format: 

charele("element-name"rStringfSizefwdir,slant>Xry); 

The  parameter  string  can  be  either  a  guoted  string 
within  the  parameter  list  or  a  pointer  to  a  character  string 
or  array.  The  character  string  will  begin  at  the  point (x^y) 
or  can  be  output  relative  to  the  present  beam  location  by 
replacing  the  x  and  y  parameter  with  the  constant  VGREL. 
For  example*  the  following  character  element*  when  linked  to 
an  object/  would  be  outDut  relative  to  the  present  beam 
posi  t  i  on : 

charele("element-nameM,"Now  is  the  t i me" ,SZ4,H0R,SLNT, VGREL) ? 

A  summary  of  the  character  element  oarameters  is 
presented  in  Table  A-II.  The  character  set  available  on  the 
vector  general  is  illustrated  in  Figure  A-5.  All  of  the  vec- 
tor general  characters  can  be  represented  within  a  character 
string.  The  special  formatting  symbols  and  svmbols  for  the 
special  vector  general  characters  are  listed  in  a  Aopendix 
B. 
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TABLE  A-II 


SUMMARY  OF  CHARACTER  ELEMENT  PARAMETERS 


size:  specify  character  size 


SZ  /  00 

SZ1  /  0100 

SZ2  /  0120 

SZ3  /  oiao 

sza  /  0160 


-  use  previously  defined  character  size 

-  set  size  to  100  columns  by  60  lines 

-  set  size  to   81  columns  by  41  lines 

-  set  size  to   60  columns  by  30  lines 

-  set  size  to   32  columns  by  16  lines 


wdir:  write  direction 

HOR  /  00     -  write  characters  horizontally 
VER  /  0200   -  write  characters  vertically 


slant:  specifies  regular  or  slanted  characters 

SLNT  /  00    -  slanted  characters 
NSLNT/  01    -  regular  characters 
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Character  Set 
FIGURE  A-5 


51 


C.   LINKING  ELEMENTS  TO  OBJECTS 

Draw  and  character  elements  represent  the  smallest  pic- 
ture segment  that  can  be  independently  referenced  by  the 
user.  In  order  to  display  an  element  it  must  be  associated 
with  at  least  one  object.  An  object  represents  the  smallest 
entity  that  can  be  displayed  independently  on  the  vector 
general  screen. 

1  .   Ob  ject  Rout  i  ne 

Each  object  is  given  a  unique  name  so  it  can  be 
easily  referenced  by  the  user.  Elements  can  be  linked  to  an 
object  at  one  time  or  by  several  different  calls  to  the 
routine  called  object.  An  object  can  consist  of  one  or  more 
elements.  A  soecific  element  can  be  linked  to  several  dif- 
ferent objects*  or  may  be  linked  to  one  object  several 
times.  This  object-element  association  or  linking  is  esta- 
blished by  the  routine  object.  This  routine  has  the  follow- 
i  ng  format : 

object(num>"object-rianie''»welement-naine"»...#"element-naine''); 

The  parameter  num  indicates  the  number  of  elements  that 
are  to  be  linked  to  the  named  object  by  this  call.  The  ele- 
ments are  referenced  by  the  names  specified,  by  the  user,  in 
the  preceding  drawele  and  charele  routines.  Since  each  ob- 
ject  is   associated   with   a   unique  name,  a  second  call  to 
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object*  with  a  duplicated  object  name*  will  cause  the  ele- 
ments to  be  added  to  the  object  first  associated  with  that 
name  • 

When  an  element  is  linked  to  a  specific  object  several 
times*  the  user  can  no  longer  reference  a  specific  oc- 
currence of  this  element  within  the  object*  for  example: 

object (3* "Tree"* "branch"*" branch", "branch") ; 


In  this  case  the  element  branch  has  been  linked  to  the 
object  tree  three  times.  When  displayed*  element  branch 
will  appear  three  times.  Now  *however*  the  user  cannot 
uniquely  reference  a  specific  occurrence  of  the  element 
branch.  If  the  element  called  branch  was  selected  to  be 
erased*  the  first  occurrence  of  branch  would  be  erased  from 
the  screen.  In  many  instances  it  may  desirable  to  uniquely 
reference  each  occurrence  of  an  element  within  a  specific 
object.  This  can  be  accomplished  by  associating  several 
unique  names  with  an  element.  The  routine  copyele  provides 
this  capabi 1 i  t y . 

2.   Copyele  Routine 

This  routine  allows  a  user  to  assign  several  unique 
names  to  a  specific  element  structure.  In  this  way*  an  ele- 
ment structure  can  be  associated  with  an  object  several 
times  and  each  occurrence  can  be  uniquely  referenced.  The 
routine  is  represented  by  the  following  format: 
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copyele(num,"e1ement-name","copyl-name","copy2-name",...); 

The  parameter  num  indicates  the  number  of  additional  names  a 
user  wishes  to  associate  with  the  named  element  structure. 
The  "element-name"  refers  to  a  previously  defined  draw  ele- 
ment or  character  element  block.  Each  of  the  "coDy-names" 
must  be  unique. 

Now  reconsider  the  previous  example.  If  the  element 
branch  is  associated  with  two  other  unique  names  and  these 
three  names  are  used  in  the  ob j ec t -el ement  linkinq,  each 
occurrence  of  the  structure  can  now  be  uniquely  referenced 
by  the  user.  The  followinq  two  statements  will  accomolish 
this  task. 

copyele(2, "branch", "branch  1", "b ranch 2" ) ; 
object (3, "tree", "b ranch ", "branch  1", "branch  2") ; 

V.   DISPLAY  MANIPULATIONS 

A.  USER  ROUTINES 

After  the  user  has  incorporated  all  data  that  is  to  be 
displayed  into  the  desired  picture  structure,  it  can  now  be 
manipulated  and  transformed.  The  followinq  user  routines 
provide  the  means  to  manioulate  the  picture,  objects  and 
elements  that  have  been  created  by  the  user. 
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A   description   of  each  user  routine*  calling  format  and 
error  diagnostics  are  included  in  Appendix  B. 


1.  Blink 

The  display  blink  mode  can  be  set  for  the  entire 
picture*  single  object  or  for  any  number  of  elements  associ- 
ated with  a  specific  object.  Modifying  the  blink  mode  of  an 
object  affects  all  the  elements  associated  with  that  object. 
The  routine  blink  will  turn  the  blink  mode  on  or  off  for  the 
specified  picture  segment. 

2.  Erase 

The  entire  picture*  a  single  object  or  any  number  of 
elements  associated  with  a  specific  object  can  be  erased 
from  the  display  screen.  The  picture  segments  that  are 
erased  from  the  screen  can  be  redisplayed  by  again  estab- 
lishing the  desired  object-element  association.  This  is 
accomplished  by  calling  the  routine  object/  as  described 
earlier.  Erasing  an  object  will  affect  all  elements  associ- 
ated with  the  named  object. 

3.  Input  Data  from  the  Display  Keyboard 

The  routine  indata  allows  a  user  to  receive  and  out- 
put characters  from  the  vector  general  keyboard  onto  the 
display  screen.  The  ASCII  character  data  is  also  placed  in 
a  user  specified  character  array  for  processing  by  the 
user's  program.  Up  to  one  line  of  text  can  be  entered*  data 
entry  is  terminated  by  a  carriage  return.  The  termination 
of  the  data  entry  also  erases  the  output  characters  from  the 
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di  spl ay    screen  . 

4.  Intensity  Offset 

The  routine  intoffset  allows  the  user  to  vary  the 
intensity  level  of  a  three  dimensional  object*  or  impose  a 
screen  cut-off  plane  for  the  named  object. 

5.  Intensity  Scale 

The  routine  intscale  allows  a  user  to  vary  the  in- 
tensity of  a  three  dimensional  object*  this  provides  the 
depth-cueing  or  shading  for  a  three  dimensional  object. 

6.  Light  Pen 

The  light  pen  se 1 ec t ab i 1 i t y  of  the  picture*  a  single 
object*  or  any  number  of  elements  associated  with  a  specific 
object  can  be  turned  on  or  off  by  the  routine  called 
lghtpen.  This  determines  what  picture  segments  will  be 
affected  by  light  oen  interactions. 

7.  Remove 

The  routine  remove  provides  a  user  with  the  ability 
to  release  the  memory  locations  associated  with  a  specific 
element  structure.  The  user  can  remove  the  picture  and 
release  all  the  memory  locations  that  have  been  used  to 
describe  all  the  existing  elements.  Additionally  the  picture 
will  be  erased  from  the  screen.  Each  element  that  is  removed 
from  memory  can  no  longer  be  referenced  or  linked  to  ob- 
jects. An  individual  element  can  also  be  removed  from 
memory*  this  will  cause  every  occurrence  of  the  element  to 
be   erased   from   the   screen   and   the    memory    locations 
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associated  with  the  element's  description  will  be  released. 
The  user  can  specify  an  element  for  removal  by  either  it's 
original  name  or  by  any  of  the  copy  names  associated  with 
it.  Remove  results  in  the  elimination  of  all  occurrences  and 
all  copies  of  an  element  from  the  display  screen.  A  element 
that  has  been  removed  can  be  redisplayed  only  by  recon- 
structing the  element  block  and  by  again  establishing  the 
desired  ob j ec t -el ement  association. 

8.  Rotate 

This  routine  allows  a  user  to  rotate  an  object  about 
the  xf  yf  and  z  axis.  The  rotation  of  an  object  affects  all 
elements  associated  with  the  named  object.  Arcs#  circles 
and  characters  are  always  drawn  in  a  plane  parallel  to  the 
screen,  and  are  rotatable  in  a  three  dimensional  coordinate 
system  about  the  z-axis. 

9.  Scale 

The  routine  scale  allows  a  user  to  scale  indepen- 
dently any  object  of  the  picture.  All  elements  associated 
with  the  object  will  be  scaled  by  the  specified  scale  fac- 
tor. 

10.  T  ransl ate 

The  routine  trans  allows  the  user  to  move  an  object 
anywhere  in  the  display  space.  The  object  and  all  its  asso- 
ciated elements  can  be  moved  in  the  x,  y,  and  z  plane.  Con- 
tinually translating  an  object  by  very  small  increments  will 
cause  it  to  appear  as  if  it  is   moving   across   the   display 
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screen.    The   following   example  will  move  the  named  object 

diagonally  across  the  display  screen: 

x  =  y  s  .01   //coordinate  system  is  20 

//ranging  from  -1  to  1. 
for( i=0; i  <100; i  ++) 
<  t  ransCbox",  x,  y); 

x  =  x  +  .01  ; 

y  =  y  +  .01  ; 
> 


VI.  OTHER  USER  INTERFACE  ROUTINES 

Additional  user  routines  are  available  and  are  described 
in  detail  in  the  Users  Manual  for  the  Vector  General  Display 
Unit  161.  Only  a  brief  summary  of  each  routine  will  be 
presented  in  this  manual. 

1 •   vgc 1 oc  k 

This  routine  allows  a  user  to  set  the  refresh  rate 
of  the  vector  general  display.  The  vector  general  is  au- 
tomatically initialized  with  a  refresh  rate  of  forty  hertz. 

2.  vgdi  al 

The  routine  vgdial  returns  to  the  user's  program  the 
values  of  the  ten  variable  control  dials. 

3.  vggetcar 

The  routine  vggetcar  will  return  to  the  user's  pro- 
gram a  single  character  entered  at  the  vector  general  key- 
board. If  no  character  has  been  entered  a  -1  will  be  re- 
turned. This  routine  does  not  display  the  characters  on  the 
vector  general  display  screen. 
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4.  vggetfsw 

This  routine  will  return  to  a  user's  program  the 
value  of  the  32  function  switches.  The  values  returned  will 
indicate  which  function  switches  are  depressed. 

5.  vgl amps 

This  routine  is  used  in  conjunction  with  vggetfsw. 
It  will  turn  on  the  function  switch  lamp  for  each  function 
switch  that  is  depressed. 

6.  vapicture 

This  routine  causes  the  user's  picture  to  be 
displayed  on  the  vector  general  display  screen.  Nothing 
will  appear  on  the  display  screen  until  this  routine  is 
cal 1 ed. 

7.  vgpost 

The  routine  vgpost  allows  the  user  to  transform  the 
pictures  coordinate  axis.  This  transformation  will  cause 
the  entire  picture  to  be  repositioned  on  the  display  screen. 

8.  vgpscal 

The  user  can  modify  the  scale  of  the  entire  picture 
by  calling  the  routine  v go seal. 

9.  vgterm 

This  routine  terminates  the  vector  general  orocess 
and  releases  all  the  systems  resources  that  were  being  util- 
ized by  the  vector  general.  This  routine  should  be  called 
at  the  conclusion  of  all  vector  general  display  ooerations. 
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VII,    RUNNING  A  VECTOR  GENERAL  PROGRAM 

A.  PROGRAM  FORMAT 

In   order  to  properly  utilize  the  vector  general  display 

system*  routines  to  initialize  and  terminate  the  system  must 

be   called.    These   routines  initialize  the  vector  general* 

start  the  actual  visual  display  and  properly   terminate   the 

display   at   the   end   of  a  users  program.  Each  user  program 

must  include  a  call  to  these  three  routines: 

s  v  s  i  n  i  t  ( ) ; 
vgpi  c  t ure ( ) * 
vgt erm ( ) ; 

The  first  routine*  sysinit*  must  be  called  by  the  user 
before  any  other  user  interface  routine  is  called.  To 
display  the  picture  that  a  user  has  described  on  the  vector 
general  screen*  the  routine  vgpicture  must  be  called.  This 
routine  is  called  only  once*  and  nothing  will  appear  on  the 
screen  until  it  has  been  called.  Finally*  to  properly  ter- 
minate* the  system  requires  a  call  to  the  routine  vgterm  at 
the  end  of  t^he  user  program. 

B.  TO  COMPILE 

Once  a  graphics  program  for  the  vector  general  has  been 
writted  in  the  C-languaae  it  must  be  compiled  with  the  user 
interface  graphics  subroutine  library.  To  include  this  in- 
formation a  user   should   issue   the   following   command   to 
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properly  compile  a  vector  general  graphics  program: 

cc  -0  f  i  1 ename  -1 v 

In   order   to  utilize  the  vector  general's  program  constants 

used  in  this  manual*  the   file   containing   these  constants 

must   be   included   in  each  graphics  program.   The  following 
command  will  include  the  file: 

^include  M/usr/l i b/vgcon .h " 
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C.   SAMPLE  PROGRAM 

The   following  is  an  examole  of  a  C-lanquage  vector  gen- 
eral graphics  program.   The  actual  picture  produced  by   this 
program  is  illustrated  in  Figure  A-6. 
#include  Vusr/1  i  b/vgcon  .h" 

mai  n ( ) 
{ 
i  n  t  i  ; 

sysinitC);   //initailize  the  vector  general 

//define  coordinate  system 
coo rdsvs (2,-1 .0,1.0,-1.0,1.0); 

drawel e("box") ; 

setvector(VA,LN) ; 

tnove(-l  .0,-1.0); 

line(  1.0,  1.0); 

line(  1.0,  1.0); 

line (-1.0,  1.0); 

1 ine(- 1.0,-1 .0); 
ende 1 e ( ) ; 

charel e( "name" ,"%I  BOX" , SZaf H0R,NSLNT, VGREL ) ; 

drawele("zigzag")  ; 

setvector(VA,l_N) ; 

move(-0.5,-0.5) 
setvector(INCX,LN, .0308, NMG) ; 
move( .0308, .0308) ; 
for(i=0    ;     i<    7    ;     i++    ) 
1 ine(.0308, .0308) ; 
endel e( ) ; 

//establish    object-element    relationship 
object (3, "bigbox", "box", "name", "zigzag"); 
ob j ec t (3, "smallbox","boxM," name", "zigzag"); 

scale("bigbox",0.5) ; 
trans ("bigbox ",-0.5, -0.5) ; 
scaleCsmal  1box",0.25); 
trans("smal 1  box", 0.5, 0.5); 

vgpicture();     //display  picture 
sleeD(30);   //display  picture  for  30  sec 
vgterm();    //terminate  vector  general  process 
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Picture  Disolayed  bv  Sample  Proaram 
FIGUPE  A-6 
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D.   ERROR  DIAGNOSTICS 

AH  error  messages  will  be  printed  on  the  PDP-11  termi- 
nal screen  during  the  execution  of  a  vector  genera)  graphics 
program.  The  error  message  will  identify  the  routine  that 
was  executing  when  the  error  occurred  and  the  error.  The 
errors  will  be  identified  by  a  number.  A  user  can  identify 
the  problem  by  referring  to  the  listing  of  errors  in  this 
manual  or  by  referencing  the  specific  routine  in  Appendix  B. 
Most  errors  will  usually  result  in  the  termination  of  the 
routine  being  executed  with  control  being  returned  to  the 
user  program.  Every  effort  will  be  made  to  execute  the  pro- 
gram to  comoletion,  so  at  least  some  of  the  users  data  will 
be  displayed  on  the  vector  general  disolay  screen.  A 
description  of  each  possible  error  is  listed  in  Table-Ill. 
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TABLE-III 
ERROR  DIAGNOSTICS 


Routine  Error  Numbers: 


arc 

1 

i  nt  seal e 

12 

61  ink 

2 

1 ghtoen 

13 

charel e 

3 

remove 

17 

ci  re  1  e 

a 

move 

15 

coordsys 

5 

ob j  ect 

16 

copyel e 

6 

remove 

17 

drawel e 

7 

rot  ate 

18 

ende 1 e 

8 

scale 

1<? 

erase 

9 

set  vec  tor 

20 

i  ndat  a 

10 

sys  i  n  i  t 

21 

i  ntof  f set 

11 

t  pans 

22 

Error  Diagnostics: 
E01 


E02 


E03 


E04 


EOS 


E06 


E07 


Element  block  error.   The  specified  routine 
has   been   called   outside  of  a  drawele  block.  The 
instruction  will  be  ignored  and   control   will   be 
returned  to  the  user's  program. 

Soace  allocated  by  the  system  for  the  buildinq 
of  elements  has  been  exceeded.  See  the  routine 
remove  in  order  to  free  ud  unecessary  element 
memory  locations.  The  instruction  executing  when 
this  error  occurs  will  be  ignored  and  control  will 
be  returned  to  the  user's  program. 

The  value  of  the  parameter  dir  was  not  C  or 

CC.    The   routine   will   be  ignored  and  no  arc  or 

circle  will  be  drawn  on  the  display. 

A  character  symbol  included  in  an  ASCII 
character  string  is  undefined.   The  symbol  will  be 
ignored  and  control  will  be  returned  to  the  user's 
program. 

The  named  object  does  not  exist?  it  has  not 
been  defined  in  a  call  to  the  routine  object. 

The  named  element  does  not  exist?  it  has  not 

been  defined   in   a   call   to   either   drawele   or 

charel e . 

An  element  name  has  been  duplicated  in  a 
drawele   or   charele  call.   Each  element  structure 
created  bv  drawele  or  charele  must  have   a   unique 
name . 
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EOS 


E09 


Ell 


The  total  number  of  elements  allowed 
by  the  system  has  been  exceeded. 

The  number  of  objects  allowed  by  the 
system  has  been  exceeded. 

The  value  of  the  parameter  dim, 

specifying   the   desired   number  of  dimensions  for 

the  user  coordinate  system  is  not  a  2.    or  3. 


E14 


The  specified  increment  value  falls  outside 
of  the  defined  coordinate  system,  the   value   will 
be   iqnored   and   control   will  be  returned  to  the 
user ' s  oroaram. 


E15 


E16 


E17 


The  x  coordinate  value/  or  the  x  increment 
value  falls  outside  of  the  user's  defined  coordi- 
nate system.  The  instruction  executing  at  the 
time  of  the  error  will  be  iqnored  and  the  mover 
line*  arc  or  circle  requested  will  not  be  drawn  on 
the  display  screen. 

The  y  coordinate  value/  or  the  y  increment 
value  falls  outside  of  the  user's  defined  coordi- 
nate system.  The  instruction  executing  at  the 
time  of  the  error  will  be  iqnored  and  the  move/ 
line/  arc  or  circle  requested  will  not  be  drawn  on 
the  disDlay  screen. 

The  z  coordinate  value/  or  the  z  increment 
value  falls  outside  of  the  user's  defined  coordi- 
nate system.  The  instruction  executing  at  the 
time  of  the  error  will  be  iqnored  and  the  move/ 
line/  arc  or  circle  requested  will  not  be  drawn  on 
the  display  screen. 


E18 


The  value  of  the  oarameter  num, 

soecifying  the  number  of  elements  being  passed 

this  routine  is  not  between  1  and  10. 


i  n 


E19 


A  circle  or  arc  cannot  be  drawn  by 
incremental  vector. 


an 


E20 


The  length  of  the  user  buffer  specified 
for   the   routine  indata  is  too  small.   The  amount 
of  data   input   from   the   keyboard   exceeded   the 
Duffer   size/  characters  received  after  the  buffer 
boundry  will  be  iqnored. 
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E21 


A  named  element  within  a  oarameter  list 
is  not  associated  with  the  specified  object.  The 
element  was  not  linked  to  the  named  object  in  a 
call  to  the  routine  object.  The  routine  executing 
at  the  time  of  this  will  stop  and  return  control 
to  the  user's  program. 
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APPENDIX  B:  USER  INTERFACE  ROUTINE  DESCRIPTIONS 

The  description  of  the  user  interface  routines  appear 
in  the  same  format  as  the  routine  descriptions  in  the  UNIX 
Reference  Manual  at  the  Naval  Postgraduate  School  Computer 
Laboratory . 
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arc 


arc 


NAME: 


arc  -  draw  an  arc 


SYNOPSIS: 

arc (di r, cent x  [»centy]  [ *  cent z)  , endx  trendy]  (>endz)  ); 

dir:  CC  /  004  -  counter  clockwise 
C  /  01 0  -  cl ockwi  se 

float  centx  (,centyl  f f cent z) , endx  [,endyl  [,endzl  ; 

DESCRIPTION: 

An  arc  is  drawn  from  the  present  beam  location,  about 
the  designated  center  pointr  to  the  user  specified  end 
point.  If  the  center  point  is  not  an  equal  distance 
from  the  starting  point  of  the  arc  and  the  end  point* 
an  arc  will  be  drawn  using  one  of  the  distances  as  the 
radius.  The  result,  is  a  straight  line  drawn  from  the 
actual  terminatina  point  of  the  arc  to  the  user  speci- 
f  i  ed  end  poi  nt . 

The  parameters  oassed  for  the  center  point  and  end 
point  of  the  arc  are  either  relative  or  absolute 
values.  The  number  and  value  of  these  parameters  are 
determined  by  the  vector  type  selected  in  the  previous 
call  to  set  vec t  or . 


Arcs  cannot  be  drawn  by  any  of 
vectors . 


the   four   incremental 


The  z  parameters  are  required  only  when  the  coordinate 
system  is  defined  as  three  dimensional/  and  will  be 
ignored  if  included  when  2    dimensional  is  specified. 


DIAGNOSTICS: 


All  error  messaaes  will  be  printed  on  the  PDP-11   ter- 
minal screen. 

Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  soace  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E03  -  The  draw  direction  was  not  defined 
as  either  C  or  CC . 

Error  -  E15  -  The  x  value  was  out  of  bounds. 
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arc 


arc 


Error  -  E16  -  The  y  value  was  out  of  bounds. 
Error  -  E17  -  The  z  value  was  out  of  bounds. 
Error  -  E19  -  Illegal  arc/circle  instruction 
from  an  incremental  vector. 


ALSO  SEE: 

set  vector 


gives  parameter  requirements  for  each 
vector  type. 
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bl  ink 


bl  ink 


NAME: 


blink  -  blink  the  entire  picture  or  the  specified 
object  or  elements 


SYNOPSIS: 

ac t  i  on  : 


ON   /  01 
OFF  /  00 


blink 

stop  blinking  action 


Parameter  values: 


PIC  /  00 
OBJ  /  -1 


To  blink  the  entire  picture: 
bl i  nk (act  i  on, PIC) ; 

To  blink  a  specific  object: 

bl ink(action,OBJ,"objname"); 

To  blink  elements  of  a  specific  object: 

b1ink(action,num, "obj  name " / " e  1  e  1  "  /  e  1  e  2 "/...); 
i  nt  num; 


DESCRIPTION: 


The  blink  mode  for  the  entire  picture/  a  single  ob- 
ject or  any  number  of  elements  of  a  soecific  object/ 
can  be  turned  on  or  off. 

Modifying  the  blink  mode  of  an  object  affects  all  ele- 
ments linked  to  that  object. 

num  specifies  the  number  of  element  names  being  passed 
in  this  routine/  num  can  vary  between  1  and  10. 


DIAGNOSTICS: 

All  errors  will  be   printed   on   the   PDP-11   terminal 
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bl  ink 


blink 


sc  reen . 


Error 
Error 
Error 


E05 
E06 
E18 


Unknown  object  name. 
Unknown  element  name. 
Value  num  not  between  1-10 
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charel  e 

NAME: 


chare  1 e 


charel e  - 


displays  an  ASCII  character  string 
on  the  Vector  General 


SYNOPSIS: 

charele(Relenamen*charptr,size»wdirfSlant»xpos,ypos); 
float  xpos,  yoos? 


size: 


sz 

/ 

00 

szt 

/ 

0100 

SZ2 

/ 

0120 

SZ3 

/ 

0140 

SZ4 

/ 

0160 

wdi  r: 

HOR 

/ 

00 

VER 

/ 

0200 

s 1  ant  : 

SLN1 

/  00 

NSLNT 

/  01 

-  use  previous  character  size 

■  set  size  to  100  col.  hy  60  lines 
1  set  size  to  81  col.  by  41  lines 

■  set  size  to  60  col.  by  30  lines 

■  set  size  to  32  col.  by  16  lines 


write  characters  horizontally 
write  characters  vertically 


s 1  ant  charac  t  ers 

do  not  slant  characters 


xpos  : 


VGREL-  to  output  characters  relative  to  the 

present  beam  position  the  parameter  xdos 
should  be  replaced  with  VGREL  and 
parameter  ypos  should  be  omitted. 


DESCRIPTION: 


This  routine  displays  the  ASCII  character  string, 
specified  bv  charptr*  on  the  vector  general  screen. 
The  characters  can  be  output  by  soecifying  the  desired 
coordinate  starting  point  (xpos^yoos)  or  by  outputing 
the  string  relative  to  the  present  beam  location.  The 
symbols  available  include  formatting  symbols  and  an 
extended  character  set.  These  can  be  included  in  any 
character  strinq  by  including  the  proper  identifying 
symbols.  The  character  string  formatting  symbols  are: 
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chare! e 


charele 


KEYBOARD 
SYMBOL 


FORMAT 


X9 
XA 
XB 
%C 
XD 
XE 
XF 
XG 
XH 
XI 
XJ 
%K 


bac kspace , moves  back  one  character  space 

line  feed*  oosition  center  screen 

1 i  ne  feed 

position  at  toprcenter  of  screen 

oosition  at  top/left  corner  of  screen 

carriage  control?  line  feed 

i  gnored 

i  gnored 

special  character 

neg.  line  feed, moves  up  one  line 

decreases  current  character  size  by  one 

increases  current  character  size  by  one 


Due  to  the  extended  character  set  available  on  the 
vector  general,  all  special  character  symbols  are  pre- 
ceded by  a  percent  sign.  In  order  to  have  a  percent 
sign  appear  on  the  screen,  two  percent  signs  (XX)  must 
appear  in  the  character  string.  A  list  of  the  special 
characters  available  are  listed  on  the  next  page  under 
Extended  Character  Set. 


DIAGNOSTICS: 


All  errors  will  be 
sc  reen . 


printed   on   the   PDP-11   terminal 


Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E04  -  Incorrect  ASCII  character  symbol 
found  in  character  string. 

Error  -  E09  -  Maximum  number  of  elements 
per  picture  exceeded. 
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charel e 


charele 


Extended  Character  Set 


KEYBOARD 
SYMBOL 


CHARACTER 


%space 

XI 

X" 

X* 

x% 

XH 
%& 
X* 
%(. 
X) 
%* 
X* 

X, 
%- 
%. 
%/ 

%0 

x\ 

X2 

XZ 

%a 

7.5 


II 

o 

V 

/ 


10 


a 

A 
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charel e 


charel e 


%b 

XI 
X8 
%9 
X: 
XJ 

x< 

XM 
%N 
XO 
XP 
XQ 
XR 
%S 
XT 
%U 

%v 
xw 

XX 
XY 
X7 

xr 

X 
XI 

xt 
x«- 


3 
z 
u 

n 


DU 

T 
o 

i> 

I 

/ 

r 


* 
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chare  1  e 


chare! e 


%% 
Za 
%b 
%c 
%d 
Xe 
%f 
%g 

%h 
%i 

%j 

%k 

%1 

%m 

%n 

*o 

%o 

%a 

%r 

%s 

%t 

%u 

%v 

%w 

%x 

%V 


oC 

13 

S7 
S 
€ 

* 

X 
v 

5 

/° 

T 

o 

y 
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chare! e 


chare! e 


Xi 

x\ 
%} 
%-• 
%? 


°0 

V 

I 
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c  i  rc  1  e 


circle 


NAME: 


circle  -  draw  a  circle 


SYNOPSIS: 

c i rc 1 e (di recent x     [,centy]     Ucentzl     ) 

dir:  CC  /  004  -  counter  clockwise 
C  /  01 0  -  clockwi  se 

float  centx  (#centyl  Ucentzl  ; 

DESCRIPTION: 

A  circle  is  drawn  from  the  present  beam  location  about 
the  indicated   center  point.  / 

The  parameters  passed  for  the  center  point  of  the  cir- 
cle are  either  relative  or  absolute  values.  The 
number  and  value  of  these  parameters  are  determined  bv 
the  vector  type  selected  in  the  previous  call  to  set- 
vector  . 

Circles  cannot  be  drawn  by  any  of  the  four  incremental 
vectors . 

DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  -  E01  -  This  routine  has  been  called  outside 

of  a  draw  element  block. 
Error  -  E02  -  The  space  allocated  for  the  buildino. 

of  elements  has  been  exceeded. 
Error  -  E03  -  The  draw  direction  was  not  defined 

as  either  C  or  CC • 
Error  -  E15  -  The  x  value  was  out  of  bounds. 
Error  -  E16  -  The  y  value  was  out  of  bounds. 
Error  -  E17  -  The  z  value  was  out  of  bounds. 
Error  -  E 1 9  -  Illegal  arc/circle  instruction 

from  an  incremental  vector. 

ALSO  SEE: 


setvector  - 


gives  parameter  reguirements  for  each 
vector  t  ype. 
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coordsys 


coordsys 


NAME: 


coordsys  -  define  user  coordinate  system 


SYNOPSIS: 

coordsys (di m , mi nx , maxx , mi ny, max y     [,minz,maxzl     )? 

i  nt    dim; 

float  m i nx , max x t m i ny , max y  Irminzfmaxz)  ? 

DESCRIPTION: 

Defines  a  two  or  three  dimensional  cartesian  coordi- 
nate system/  of  any  scale*  for  the  user.  The  parameter 
dim  specifies  the  number  of  dimensions  required.  If 
dim  is  2  then  only  the  range  of  x  and  y  need  to  be 
spec  i  f  i  ed. 

minx  must  be  strictly  less  than  maxx. 

miny  must  be  strictly  less  than  maxy. 

minz  must  be  strictly  less  than  maxz. 

All  subseauent  user  coordinate  values  are  interpreted 
according  to  this  user  defined  coordinate  system. 

If  coordsys  is  not  called  by  the  user  the  default 
values  will  be  taken.  The  default  coordinate  system  is 
three  dimensional  with  *f  y,  z  ranging  from  -100.0  to 
100.0.  All  coordinate  values  received  will  be  inter- 
preted according  to  these  default  values  unless  the 
coordinate  system  is  redefined  by  the  user. 

DIAGNOSTICS: 

Any  values  which  fall  outside  of  the  defined  coordi- 
nate system  will  be  ignored  and  an  error  message 
specifying  which  coordinate  values  were  out  of  range 
will  be  printed  on  the  PDP-11  terminal  screen. 
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copyel e 


copyel e 


NAME: 


copyele  -  specify  additional  names  to  be  used 

in  referencing  a  specific  element  block 


SYNOPSIS: 

copye1e(num»"elename" rMnamel">" name2 "*...); 
int  num; 

DESCRIPTION: 

This  routine  allows  the  user  to  give  several  unique 
names  to  a  specific  element  block.  In  this  manner*  a 
user  can  link  one  element  to  an  object  several  times 
and  can  uniquely  reference  each  occurrence  of  the 
element  within  the  object. 

num  specifies  the  number  of  element  names  being  passed 
in  this  routine,  num  can  vary  between  1  and  10. 


DIAGNOSTICS: 


All  error  messaqes  will  be  printed  on  the  PDP-11 
minal  screen. 

Error  -  E06  -  Unknown  element  name. 
Error  -  E07  -  Duplicate  element  name. 
Error  -  E18  -  Value  num  not  between  1-10. 


t  er- 


ALSO  SEE: 

drawel e#  ob  j  ec  t 
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drawel e 


drawel e 


NAME: 


drawele  -  start  a  draw  element  block 


SYNOPSIS: 

draweleCelename")  ? 

DESCRIPTION: 

This  routine  specifies  the  beginning  of  a  draw  element 
block.  It  associates  a  unique  name  with  the  grouo  of 
draw  instructions  that  fall  in  between  this  call  and  a 
call  to  endele.  The  resulting  picture  segment  will 
then  be  referenced  by  the  name  SDecifiedr  as  the  ele- 
ment name*  in  this  routine, 

A  user  may  want  to  repeat  a  specific  element  block 
structure  several  times  within  one  object.  Instead  of 
soecifying  several  element  blocks  which  describe  the 
same  structure  a  user  can  indicate  a  group  of  names 
which  refer  to  one  specific  element  block.  These 
unigue  names  each  referring  to  the  same  structure  can 
then  be  linked  to  an  object,  and  each  can  be  uniquely 
referenced.  This  association  of  several  names  with  one 
element  can  be  accomplished  by  the  routine  cooyele. 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11   ter- 
minal sc  reen . 

Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E07  -  Duplicate  element  name. 


ALSO  SEE: 

copyele/  object 
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endel e 


endel e 


NAME: 


endele  -  end  of  the  current  element  block 


SYNOPSIS: 

endel e ( ) ? 

DESCRIPTION: 


Specifies  the  termination  of  a  list  of  draw  instruc- 
tions describing  a  specific  element.  The  picture  seg- 
ment described  by  this  group  of  draw  instructions* 
that  fall  between  a  drawele  and  endele  call»  will  be 
referenced  by  name  specified  in  the  drawele. 

A  new  element  block  cannot  begin  until  the  previous 
block  has  been  orooerly  terminated  by  a  call  to 
endel e. 


DIAGNOSTICS: 


This  routine  must  be  called  to  properly  end  a  draw 
element  block.  If  a  block  is  not  properly  terminated 
prior  to  the  beginning  of  a  new  element  block,  all 
drawele  calls  will  be  iqnored  and  any  draw  instruc- 
tions that  follow  will  be  associated  with  the  element 
block  that  has  not  been  terminated. 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  soace  allocated  for  the  building 
of  elements  has  been  exceeded. 
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erase 


erase 


NAME: 


erase  -  erase  the  specified  portions  of  the  picture 


SYNOPSIS: 

Parameter  values: 

PIC  /  00 
OBJ  /  -1 

To  erase  the  entire  picture: 

erase(PIC); 
To  erase  a  specific  object: 

erase (OBJ, "obj name" )  ; 

To  erase  elements  of  a  specific  object: 

epase(numfHobjname%Meleln,,,ele2%  ..); 
i  nt     num; 

DESCRIPTION: 

The  entire  oicture,  specified  object  or  the  listed 
elements  of  a  specific  object,  will  be  erased  from  the 
vector  general  display  screen.  The  elements  still 
exist.  To  redisplay  any  portion  of  the  erased  picture, 
the  appropriate  el ement -ob j ec t  linking  must  again  be 
done  by  the  user. 

num  specifies  the  number  of  element  names  being  passed 
in  this  rout  i  ne . 

DIAGNOSTICS: 


All  error  messages  will  be  printed  on  the  PDP-11 

minal  screen.  •■ 

Error  -  £05  -  Unknown  object  name. 
Error  -  E06  -  Unknown  element  name. 
Error  -  E18  -  Value  num  not  between  1-10. 
Error  -  E2 1  -  Element  not  associated  with 
the  named  object  . 


t  er- 


ALSO  SEE: 


remove 


84 


er rormsg 


er  rormsg 


NAME: 


errormsq  - 


print  error  messages  on  PDP-11  terminal 
sc  reen 


SYNOPSIS: 

errormsg(action); 

act  i  on : 

ON   /  01  - 
OFF  /  00  - 


print  errors  on  PDP-11  terminal 
stoo  printing  of  error  messaaes 


DESCRIPTION: 


All  error  messaaes  will  automatically  be   printed   on 

the   PDP-11   terminal  screen.  The  user  can  control  the 

printing  of  error  messaaes  during   any  portion   of   a 
Drogram  by  calling  this  routine. 
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i  ndat a 


i  ndat a 


NAME: 


indata  -  input  data  from  the  vector  general 
keyboard 


SYNOPSIS: 

indata(buffer, length,xpos,yoos) ; 
char  *buffer; 
i  nt  1 engt  h ; 
float  xpoSfVpos? 


DESCRIPTION: 


This  routine  allows  the  user  to  enter  data  from  the 
vector  general  keyboard  onto  the  vector  general 
display  screen  beginning  at  the  position  indicated  by 
xpos/  ypos.  The  data*  ASCII  character  codes,  will 
also  be  Dlaced  in  the  user  buffer  SDecified  by  buffer. 
The  length  of  the  user  buffer  must  be  SDecifed  by  the 
parameter  length.  A  cursor  will  be  displayed  at  the 
initial  position  and  all  data  will  remain  on  the 
display   screen   until  a  carriage  return  is  entered  by 


the  user.  All  data  placed  in  the 
remain  unaltered. 


user  s 


A  listing  of  the  ASCII  character  code  for 
board  entry  is  listed  on  the  next  page. 


buffer   will 


every   key- 


DIAGNOSTICS: 


All   error  messages  will  be  printed  on  the  PDP-11  ter 
minal  screen. 

Error  -  E15  -  The  x  value  was  out  of  bounds. 
Error  -  E16  -  The  y  value  was  out  of  bounds. 
Error  -  E  2  0  -  User  buffer  dimensioned  to  small. 
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i  ndata 

OCTAL 

CHARACTER 

GENERATED 

KEYBOARD 

CODE 

SYMBOL 

SYMBOL 

000 

NULL 

( i  qnored) 

9 

Ctrl 

001 

SO      erase  last  char. 

A 

Ctrl 

002 

STX 

( i  anored) 

B 

Ctrl 

003 

ETX 

( i  qnored) 

C 

Ctrl 

004 

EOT 

( i  qnored) 

D 

Ctrl 

005 

ENQ 

( i  qnored) 

E 

Ctrl 

006 

ftCK 

( i qnored) 

F 

Ctrl 

007 

BEL 

( i  onored) 

G 

Ctrl 

010 

BS 

BS 

Oil 

HT 

(LF,  cent) 

I 

Ctrl 

012 

LF 

LF 

013 

VT 

(top,  cent ) 

K 

Ctrl 

oia 

FF 

(top,  left) 

L 

Ctrl 

015 

NL 

(CR,  LF) 

CR 

016 

SE 

( i  anored) 

N 

Ctrl 

017 

SI 

( i  onored) 

0 

Ctrl 

020 

DLE 

(clear  Queue) 

p 

Ctrl 

021 

DC1 

(-LF) 

Q 

Ctrl 

022 

DC2 

(-SZ) 

R 

Ctrl 

023 

DC3 

(fSZ) 

S 

Ctrl 

02a 

Dca 

( t ermi  nate) 

T 

ct  rl 

025 

NAK 

( i  anored) 

U 

Ctrl 

026 

SYN 

( i  anored) 

V 

Ctrl 

027 

ET3 

( i  anored) 

w 

Ct  rl 

030 

CAN 

( i  anored ) 

X 

Ctrl 

031 

EM 

( i  anored) 

Y 

Ctrl 

032 

SUB 

( i  anored) 

Z 

Cfl 

033 

ESC 

(escape) 

[ 

Ctrl 

03a 

FS 

( i  anored) 

\ 

ct  r] 

035 

GS 

( i  anored) 

1 

Ct  rl 

036 

RS 

( i  qnored) 

y\ 

Ctrl 

037 

US 

( i  anored) 

oao 

Space 

sp  bar 

oai 

• 

1 

shift 

oa2 

M 

2 

shi  ft 

oa3 

ft 

3 

shi  ft 

oaa 

% 

a 

shi  ft 

oa5 

% 

5 

shi  ft 

oa6 

& 

6 

Shi  ft 

oa7 

1 

7 

Shift 

050 

( 

8 

shift 

051 

) 

9 

shi  ft 

052 

* 

• 
• 

Shift 

053 

♦ 

• 
9 

shift 

05a 

t 

9 

055 

- 

• 

056 

• 

• 

057 

/ 

/ 

060 

0 

0 

i  ndata 
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i  ndat a 

061 

l 

062 

2 

063 

3 

064 

a 

065 

5 

066 

6 

067 

7 

070 

8 

071 

Q 

072 

• 
• 

073 

• 
r 

07a 

< 

075 

r 

076 

> 

077 

9 

• 

100 

s 

101 

A 

102 

B 

103 

C 

ioa 

D 

105 

E 

106 

F 

107 

G 

110 

H 

111 

I 

112 

J 

113 

K 

lia 

L 

115 

M 

116 

M 

117 

0 

120 

p 

121 

0 

122 

R 

123 

S 

12a 

T 

125 

U 

126 

V 

127 

w 

130 

X 

131 

Y 

132 

z 

133 

[ 

13a 

\ 

135 

1 

136 

A 

137 

«- 

iao 

% 

iai 

a 

142 

h 

143 

c 

iaa 

d 

i  ndat  a 


shi  f 

shi  f 
shi  f 


ub  t suoersc  ri  pt ) 


1 

2 
3 
a 
5 
6 
7 
8 


• 

3 

A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 

M 

N 

0 
p 

a 
p 
s 

T 

U 
V 

w 

X 

Y 

z 
[ 

\ 

1 


3  shift 

A 

B 

C 

0 


sh 
sh 
Sh 
Sh 
Sh 
Sh 
Sh 
sh 
Sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
sh 
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i  ndat  a 

ias 

e 

ia6 

f 

ia7 

9 

150 

h 

151 

i 

152 

J 

153 

k 

15a 

1 

155 

m 

156 

h 

157 

o 

160 

D 

161 

a 

162 

r 

163 

s 

16a 

t 

165 

u 

166 

V 

167 

w 

170 

X 

171 

V 

172 

z 

173 

< 

17a 

1 
1 

175 

> 

176 

rJ 

177 

del 

2ao 

J 

2ai 

2a2 

1! 

2a3 

o 

2aa 

fc 

2a5 

V 

2a6 

/ 

2a7 

i 

250v 

c 

251 

•=> 

252 

10 

253 

jLm 

'  8 

25a 

^ 

255 

s 

256 

b» 

257 

— 1 

260 

o 

t 

261 

262 

V 

263 

a 

26a 

jt 

265 

A 

266 

3 

267 

Z. 

270 

u 

i  ndata 


(  subsc  r*i  pt ) 


(centered) 


E 

F 

r, 

H 

I 
J 

K 

L 
M 
H 
0 
P 
Q 
P 
S 
T 
U 
V 

w 

X 

Y 

7 

)  shi  f 
\  shi  f 

f  shi  f 
/\  shi  f 

DEL 

space 

1  shi  f 

2  s  h  i  f 
shi  f 
shi  f 
shi  f 
shi  f 
shi  f 
shi  f 
shi  f 

:  s  h  i  f 
;  s  h  i  f 
,  spec 
-  spec 
.  spec 
/  spec 
0  spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 


spec 

t  spec 
SDec 
spec 
spec 
spec 
spec 
spec 
sc>ec 
spec 
spec 
spec 
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i  ndat a 


i  ndata 


271 

n     , 

272 

•       (centered) 

273 

X 

274 

<rj 

315 

316 

71 

317 

n 

320 

IT 

321 

o 

322 

J> 

323 

S 

32^ 

e 

325 

L 

326 

S 

327 

A 

330 

r 

331 

r~ 

332 

__ 

333 

L 

33a 

^> 

335 

h 

336 

* 

337 

o   * 

340 

j ,      ( b 1  inking) 

341 

<£. 

3a2 

P 

3a3 

V 

3aa 

§ 

3a5 

£ 

346 

* 

347 

* 

350 

-L 

351 

u 

352 

N 

353 

<  * 

354 

A- 

355 

JUI 

356 

V 

357 

u) 

360 

TT 

361 

& 

362 

e 

363 

<? 

36a 

1 

365 

-y 

366 

o 

367 

J 

370 

I 

e 

371 

^ 

372 

<\J 

373 

37a 

r 

^ 

spec 

• 
* 

spec 

* 
* 

spec 

> 

sh 

i  ft  spec 

M 

sh 

i  ft  spec 

N 

sh 

i  ft  spec 

0 

sh 

i  ft  spec 

P 

sh 

i  ft  spec 

Q 

sh 

i  ft  spec 

R 

sh 

i  f  t  spec 

S 

sh 

i  ft  spec 

T 

sh 

i  ft  spec 

U 

sh 

i  ft  spec 

V 

sh 

i  ft  spec 

w 

sh 

»  ft  spec 

X 

sh 

i  ft  spec 

Y 

sh 

i  ft  spec 

Z 

sh 

i  ft  spec 

r 

sh 

i  ft  spec 

spec 

l 

sh 

i  ft  spec 

a 

spec 

.spec 

i" 

"sh- 

i  ft  spec 

4 

sh 

i  ft  spec 

R 

sh 

i  ft  spec 

C 

sh 

i  ft  spec 

D 

sh 

i  f  t  spec 

E 

sh 

i  ft  spec 

p 

sh 

i  ft  spec 

G 

sh 

i  ft  spec 

H 

sh 

i  ft  spec 

I 

sh 

i  ft  spec 

J 

Sh 

i  ft  spec 

K 

Sh 

i  ft  spec 

L 

sh 

i  ft    spec 

M 

sh 

i  ft  spec 

NJ 

sh- 

i  ft  spec 

0 

sh- 

i  ft  spec 

P 

sh 

i  ft  spec 

Q 

sh- 

i  ft  spec 

P 

sh- 

' ft  spec 

S 

Shi 

' ft  spec 

T 

shi 

' ft  spec 

U 

shi 

ft  spec 

V 

shi 

ft  spec 

w 

shi 

ft  spec 

y 

shi 

ft  spec 

Y 

shi 

ft  spec 

7 

shi 

ft  spec 

[ 

sp< 

?c  sh  i  f  t 

sc 

>ec 

shi  ft 
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i ndat a 


i  ndata 


375 
376 
377 


H 


]  spec  shift 
a  spec  shift 
DEL  spec 
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i  ntof f  set 


i  ntof  f set 


NAME: 


intoffset  -  object  intensity  offset 


SYNOPSIS: 

intoffset("objname"»val ); 
float  val; 

DESCRIPTION: 

The  intensity  ranqe  of  the  specified  object  is  deter- 
mined by  the  parameter  val.  If  val  is  oner  the  max- 
imum intensity  ranqe  is  achieved.  If  the  value  is 
zero*  the  intensity  is  constant  and  the  image  has  no 
depth-cue  i  nq. 

DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  -  E05  -  Unknown  object  name. 

ALSO  SEE: 

i  nt  sea  1 e 
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i  nt  sea! e 


i  nt  seal e 


NAME: 


intscale  -  modify  object  intensity  scale 


SYNOPSIS: 

intscale("objname",va1 ); 
float  vai; 

DESCRIPTION: 

The  intensity  range  of  an  object/  which  qives  a  three 
dimensional  object  its  depth  cueing,  is  determined  by 
the  parameter  vai.  The  range  of  val  is  from  zero  to 
one.  If  val  is  one  the  maximum  intensity  range  is 
obtained,  if  it  is  zero  the  object  has  no  depth  cue* 
i  ng. 

DIAGNOSTICS: 

All  error  messages  will  be  orinted  on  the  PDP-11  ter- 
minal sc  reen . 

Error  -  EOS  -  Unknown  object  name. 

ALSO  SEE: 

i  ntof  f set 
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1 ghtpen 


1 ghtpen 


NAME: 


lghtpen  -  set  lightpen  hookability  of 

the  pi cture, ob j ec t  or  elements 


SYNOPSIS: 

action: 


ON   /  01  -  Set  light  pen  hookability 
OFF  /  00  -  Clear  light  pen  hookability 

Parameter  values: 

PIC  /  00 
OBJ   /  -1 

To  set  hookability  of  the  entire  picture: 

lghtpen(action,PIC); 

To  set  hookability  of  an  object: 

IghtoenCact  ion, OBJ, "objname")  ; 

To  set  hookability  of  elements  of  a  specific  object: 
lghtpen(action,num,"objname"fHelel%Mele2w,...); 
i  nt  num; 


DESCRIPTION: 


The   user   can   SDecify  which  picture  segments  will  be 
light  pen  hookable.  These  elements  designated  as  light 
pen  hookable  will  be  effected  by  light  pen  interaction 
vwith  the  vector  general  disolay  screen. 

num  specifies  the  number  of  element  names  being  passed 
in  this  routine,  num  can  vary  between  1  and  10. 


DIAGNOSTICS: 


All  errors  will  be   printed   on   the   PDP-11 
sc  reen . 

Error  -  E05  -  Unknown  object  name. 

9a 


terminal 


1 qhtpen 


1 gh tpen 


Error  -  E06  -  Unknown  element  name. 
Error  -  E18  -  Value  num  not  between  1-10. 
Error  -  E21  -  Element  not  associated  with 
the  named  ob  j  ec  t  . 
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1  i  ne 


1  i  ne 


NAME: 


line  -  draw  a  line 


SYNOPSIS: 

HneCparx     Irparyl     CrparzJ     ); 
float    parx     [,paryl     I/parzJ     ; 

DESCRIPTION: 

A  line  is  drawn  to  the  location  soecified  by  the  x,y,z 
coordinate  values.  The  values  may  specify  actual  abso- 
lute coordinate  points  or  an  incremental  value  which 
will  be  added  to  or  subtracted  from  the  previous  xrVtZ 
coordinate  point.  The  number  of  parameters  and  their 
values  are  determined  by  the  vector  type  specified  in 
the  preceding  call  to  setvector. 

DIAGNOSTICS: 


All   error  messages  will  be  printed 
minal  screen. 


on  the  PDP-1 1  ter- 


Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  soace  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E15  -  The  x  value  was  out  of  bounds. 

Error  -  E16  -  The  y  value  was  out  of  bounds. 

Error  -  E17  -  The  z  value  was  out  of  bounds. 


ALSO  SEE: 

setvector 


gives  parameter  requirements  for  each 
vector  type. 
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move 


move 


NAME: 


move  -  move  to  the  specified  location 


SYNOPSIS: 

move(oarx     (,pary]      t>papzl     )? 
float    parx     [,pary]      [fparz)     ; 

DESCRIPTION: 

The  beam  is  moved  to  the  location  specified  by  the 
xrViZ  coordinate  values.  The  values  may  specify  actual 
absolute  coordinate  points  or  an  incremental  value 
which  will  be  added  to  or  subtracted  form  the  previous 
x»y»z  coordinate  values.  The  number  of  parameters  and 
their  values  are  determined  by  the  vector  type  soeci- 
fied  in  the  preceding  call  to  setvector. 

DIAGNOSTIC: 


All   error  messages  will  be  printed 
mi  na 1  sc  reen . 


on  the  PDP-11  ter- 


ALSO  SEE: 


Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  buildino 
of  elements  has  been  exceeded. 

Error  -  E15  -  The  x  value  was  out  of  bounds. 

Error  -  E16  -  The  y  value  was  out  of  bounds. 

Error  -  E17  -  The  z  value  was  out  of  bounds. 


setvector  -  gives  parameter  requirements  for  each 
vector  tyoe. 
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ob j  ec t 


ob j  ect 


NAME: 


object  -  link  elements  to  specified  object  name 


SYNOPSIS: 

object (num, Hob j name", "el  el" , " el e2" ,  . .  .  .  )  ; 

int  num? 

DESCRIPTION: 

Associates  with  the  named  object  each  of  the  listed 
elements.  This  picture  segment,  or  element  grouping 
will  be  referenced  by  the  object  name  specified  in 
this  rout  i  ne. 

Every  element  must  be  linked  to  at  least  one  object 
inorder  for  it  to  be  displayed  on  the  vector  general 
screen.  A  user  can  link  one  or  more  element  names  to 
an  object.  Elements  can  be  linked  to  an  object  by  one 
or  several  calls  to  this  routine.  An  element  can  be 
linked  to  several  different  objects,  or  one  element 
may  be  linked  several  times  to  the  same  object. 

If  an  object  or  element  has  been  erased  from  the 
display  screen,  a  user  can  redisplay  the  desired  ob- 
ject or  elements  by  again  establishing  the  desired 
ob j ec t -el ement  association. 

num  specifies  the  number  of  element  names  being  passed 
in  this  routine,  num  can  vary  between  1  and  10. 

DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 


Error 
Error 
Error 


E05 
E06 
E08 


Error  -  E09  - 


Unknown  object  name. 

Unknown  element  name. 

Number  of  elements  allowed 

per  picture  exceeded. 

Maximum  number  of  objects 

allowed  per  picture  (105  exceeded. 


ALSO  SEE: 


drawe 1 e ,  copye  1  e 
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remove 


remove 


NAME: 

remove  -  erase  the  indicated  portion  of  the  picture 
and  remove  the  associated  elements  from 
memory 

SYNOPSIS: 

Parameter  values: 

PIC  /  00 

To  remove  the  entire  picture: 

remove (PIC ) ; 

To  remove  element  structures  : 

remove(num,Melel"r"ele2 "*..); 
i  nt  num; 

DESCRIPTION: 

The  entire  picture*  or  every  occurrence  of  the  named 
elements  are  erased  from  the  vector  general  display 
screen.  Each  name  element  structure  will  be  removed 
f  rom  memory  . 

To  redisplay  any  portion  of  the  removed  picture  re- 
quires that  the  user  rebuild  each  element  and  relink 
it  to  the  aopropriate  objects. 

num  specifies  the  number  of  element  names  being  passed 
in  this  rout  i  ne . 


DIAGNOSTICS: 


All  error  messages  will  be  printed  on  the  PDP-11   ter- 
minal sc  reen . 

Error  -  E05  -  Unknown  object  name. 
Error  -  E06  -  Unknown  element  name. 
Error  -  E18  -  Value  num  not  between  1-10. 
Error  -  E21  -  Element  not  associated  with 
t  he  named  ob j  ect . 


ALSO  SEE: 


erase 
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rotate 


rot  ate 


NAME: 


rotate  -  rotate  an  object 


SYNOPSIS: 

rot  ate ( "obj name" , x radi ans> yradi ans  t*zradians)  ); 
float  xradiansfypadians  Uzradians)  J 

DESCRIPTION: 

The  named  object  will  be  rotated  about  the  x,  y*  z 
coordinate  axis*  The  parameters/  given  in  radian  meas- 
urer specify  the  degree  of  rotation  desired  about  each 
axis. 

The  z  parameter  is  reguired  only  when  the  coordinate 
system  is  defined  as  three  dimensional  and  will  be 
ignored  otherwise. 

DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  -  EOS  -  Unknown  object  name. 
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seal  e 


seal  e 


NAME: 


scale  -  modify  object  scale 


SYNOPSIS: 

seal e ( Mobj name" i    scale)? 
f 1  oat  seal e; 

DESCRIPTION: 

All  elements  associated  with  the  named  object  are 
scaled  bv  the  value  scale  at  display  time.  The  range 
of  scale  is  from  zero  to  one.  If  not  established  by  a 
user  this  value  automatically  defaults  to  oner  which 
is  the  maximum  picture  scale. 

DIAGNOSTICS: 

All  error  messaaes  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  -  E05  -  Unknown  object  name. 
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set  vector 


set  vector 


NAME: 


setvector  -  specify  the  vector  type  and  vector  mode 


SYNOPSIS: 

set  vector (vtype* vmode  [» incl  l* scale]  ); 


vtype: 


VR 

VRX 

VRY 

VRZ 

VA 

VAX 

VAY 

VAZ 


vector  rel at  i  ve 

vector  relative  auto- increment  x 

vector  relative  auto-increment  y 

vector  relative  auto-increment  z 


vector  absol ut  e 

vector  absolute  auto-increment  x 
vector  absolute  auto-increment  y 
vector  absolute  auto-increment  z 
INC2  -  vector  incremental  2-di mens i onal 
INCX  -  vector  incremental  auto-increment 
INCY  -  vector  incremental  auto-increment 
INC3  -  vector  incremental  3-d i mens i ona 1 


vmode : 

LN 

/   00 

• 

OSH 

/  020 

DOT 

/  040 

PMT 

/  060 

DO 

/0120 

ODD 

/0140 

scale: 


MG   /  000  - 


NMG  /0200  - 


1  i  ne 

dashed  1 i  ne 
dot  ted  1 i  ne 
end  point 
dash-dot -dash 
dash-dot -dash 


1  i  ne 
line 


add  the   coordinate  increments 
to  the  high  order  bits  of  the 
specified  register, 
add  the  coordinate  increments 
to  the  low  order  bits  of  the 
specified  register. 


float  inc; 


DESCRIPTION: 


This  routine  specifies  which  one  of  the  12  vector 
types  is  to  be  drawn  in  the  line*  mover  circle  and  arc 
instructions  which  follow.  It  also  specifies  the  vec- 
tor mode  (i.e.*  liner  dotted*  dashed*  etc.)/  and  if 
required*  the  increment  value  for  auto-increment  vec- 
tors  and   the   scale   factor  for  incremental  vectors. 
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setvector 


set  vector 


The  coordinate  values  passed  in  the  following  draw 
instructions  are  dependent  on  the  vector  type  selected 
in  this  rout  i  ne. 

This  must  follow  a  drawele  call  and  preced  any  draw 
instructions.  This  routine  can  be  called  any  number  of 
times  within  a  draw  element  block. 

The  bracketed  z  parameters  are  required  only  when  the 
coordinate  system  has  been  defined  as  three  dimension- 
al . 


DIAGNOSTICS: 


All  error  messages  will  be  printed  on  the  PDP-11 
m  i  na 1  sc  reen  . 


ter- 


Error  -  EO 1  - 


Error  -  E02  - 


Error 
Error 
Error 
Error 
Error 


E13 

E15 
E16 
E17 
E19 


This  routine  has  been  called  outside 

of  a  draw  element  block. 

The  soace  allocated  for  the  building 

of  elements  has  been  exceeded. 

Vector  type  undefined. 

The  x  value  was  out  of  bounds. 

The  y  value  was  out  of  bounds. 

The  z  value  was  out  of  bounds. 

Illegal  arc/circle  instruction 

from  an  incremental  vector. 
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setvector  -  VA 


set  vec  tor  -  VA 


NAME: 


VA  -  vector  absolute 


SYNOPSIS: 


draweleCelename")  ; 


setvector (VA,vmode); 

move (coordx r coordy  frcoordzl  )/ 

1 i ne (coordx #coordy  (rcoordz)  ); 

c i re  1 e (di r $  cent x *  cent y  Ircentz)  )? 

arc (di r#cent x , cent y  ( * cent z)  i endx , endy  (»endzl  ); 


endel e ( ) ? 

float  coordx , coordy  UcoordzJ  ; 

float  centXfCenty  I  »cent zl  t endx , endy  trendzl? 


DESCRIPTION: 


The  x»ytZ  coordinates  of  absolute  vectors  are  speci- 
fied with  respect  to  the  origin,  or  zero  position  of 
the  user  defined  coordinate  system.  Each  x,  y,  z  coor- 
dinate value  references  a  unique  point  on  the  display 
screen. 


DIAGNOSTICS: 


All   error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E13  -  Vector  type  undefined. 

Error  -  E15  -  The  x  value  was  out  of  bounds. 

Error  -  E16  -  The  y  value  was  out  of  bounds. 

Error  -  E17  -  The  z  value  was  out  of  bounds. 
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setvector  -  VAX 


setvector  -VAX 


NAHE: 


VAX  -  vector  absolute  auto-increment  x 


SYNOPSIS: 

draweleCelename")  ? 


setvector(VAX,vmode»xinc); 

move(coordy     [jcoordzl     ); 

move(coordy     Ucoordz)     )? 

c i pc 1 e (di r, cent y     trcentzl     )? 

arc (di r* cent v     I>  cent z)  f endy     t»endzJ)J 


endel e ( ) ; 

float  xinCf  coordy  Ucoordzl  ; 
float  centy  (»centzl »endy  (,endzJ ? 


DESCRIPTION: 


The  vector  absolute  auto-increment  x  causes  the  ini- 
tial x  coordinate  value  to  be  incremented  or  decre- 
mented by  the  value  specified  by  xinc.  With  every 
move»  line^  arc»  or  circle  command  the  specified  y  and 
z  coordinate  values  are  updated  while  the  x  coordinate 
value  is  stepped  by  the  constant  value  xinc.  For 
example*  the  point(x,  y,  z)  becomes  point (x+xinc» 
coordy,  coordz). 


The  value  of  xinc  cannot  exceed  the  ranqe  of 
fined  coordinate  system. 


the   de- 


DIAGNOSTICS: 


All   error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E13  -  Vector  type  undefined. 

Error  -  E14  -  The  increment  value  was  out  of 
bounds . 

Error  -  E16  -  The  y  value  was  out  of  bounds. 

Error  -  E17  -  The  z  value  was  out  of  bounds. 
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setvector  -  VAY 


setvector  -  VAY 


NAME: 


VAY  -  vector  absolute  auto-increment  y 


SYNOPSIS: 

drawele(HelenameM); 


set  vector (VAY rvmoderyinc)? 
moveCcoordx  UcoordzJ  )? 
1ine(coordx  Ucoordz)  ); 
circle(dir>centx  Ircentzl  )? 
arc  (di  r,  cent  x  t  r  cent  z)  i  endx  Uendz]); 


endel e ( )  ? 

float  yinc#coordx  [,coordzl  ; 
float  centx  Ucentz)  /endx  Uendzl; 


DESCRIPTION: 


The  vector  absolute  auto-increment  y  causes  the  ini- 
tial y  coordinate  value  to  be  incremented  or  decre- 
mented by  the  value  specified  by  yinc.  With  every 
move*  line*  arc  or  circle  command  the  specified  x  and 
z  coordinate  values  are  updated  while  the  y  coordinate 
value  is  stepped  by  the  constant  value  yinc.  For 
example*  the  point(xryrz)  becomes  poi nt ( coordx , y+y i nc / 
coordz ) . 

The  value  of  yinc  cannot  exceed  the  range  of  the  de- 
fined coordinate  system. 


DIAGNOSTICS: 


All  error  messages  will  be  printed  on  the  PDP-11 
mi  na 1  sc  reen • 


ter- 


Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E13  -  Vector  type  undefined. 

Error  -  E14  -  The  increment  value  was  out  of 
bounds • 

Error  -  E15  -  The  x  value  was  out  of  bounds. 

Error  -  E17  -  The  z  value  was  out  of  bounds. 
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setvector  -  VAZ 


setvector  -  VAZ 


NAME: 


VAZ  -  vector  absolute  auto-increment  z 


SYNOPSIS: 


draweleCelename")  ? 


set  vector (VAZ, vmode,zinc)? 

move(coordxrcoordy); 

1  ine(coordx,coordy)» 

c  i  r  c  1  e  ( d  i  r,centxrcenty)? 

arc(dir,centx,centyrendx,endy); 


endel e( ) ; 

float  z i nc r coordx , coordy ; 
float  cent x / cent y $ endx , endy; 


DESCRIPTION: 


The  vector  absolute  auto-increment  z  causes  the  ini- 
tial z  coordinate  value  to  be  incremented  or  decre- 
mented by  the  value  specified  by  zinc.  With  every 
move,  line,  arc  or  circle  command  the  specified  x  and 
y  coordinate  values  are  updated  while  the  z  coordinate 
value  is  stepped  by  the  constant  value  zinc.  For 
example  the  point(x,y,z)  becomes  poi nt (coordx , coordy t z 
♦  z  i  nc  )  . 

The  value  of  zinc  cannot  exceed  the  ranae  of 
fined  coordinate  system. 


the   de- 


DIAGNOSTICS: 


All   error  messages  will  be  printed 
mi  nal  sc  reen  • 


on  the  PDP-11  ter- 


Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E13  -  Vector  type  undefined. 

Error  -  E14  -  The  increment  value  was  out  of 
bounds  • 

Error  -  E15  -  The  x  value  was  out  of  bounds. 

Error  -  E16  -  The  y  value  was  out  of  bounds. 
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setvector  -  VR 


setvector  -  VR 


NAME:  VR  -  vector  relative 


SYNOPSIS: 


draweleCelename")? 


setvector (VR^vmode); 

move (del  tax , del t ay     Udeltazl     )? 

H  ne  (del  t  ax  r  de  1  tav     Udeltazl     ); 

circle(dir»centxfcentvf  Icentzl ); 

arc(dirfcentx,centy(,centzl »endx»endy t^endzl ) ' 


ende 1 e ( ) ; 

float  del t ax , de 1 t ay  Irdeltazl  ; 

float  centx,centy  ( t cent z) / endx , endy  [»endzl  J 


DESCRIPTION: 


Relative  vectors  specify  a  increment  value  that  is  to 
be  added  to  or  subtracted  from  the  initial  x»y/Z  abso- 
lute coordinate  values.  For  example^  the  point(x,y,z) 
becomes  poi nt ( x+del t ax ,    y+de 1 t ay t  z  +  del t az ) . 


The  parameter  values  cannot  exceed  the 
defined  coordinate  system. 


range   of   the 


DIAGNOSTICS: 


All   error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reeri . 

Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E13  -  Vector  type  undefined. 

Error  -  E15  -  The  x  value  was  out  of  bounds. 

Error  -  E16  -  The  y  value  was  out  of  bounds. 

Error  -  E17  -  The  z  value  was  out  of  bounds. 
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setvector  -  VRX 


setvector  -  VRX 


NAME: 


VRX  -  vector  relative  auto-increment 


SYNOPSIS: 


drawele("e1ename") ; 


setvector(VRX,vmode*xinc) 
moveCdeltay  UdeltazJ  ); 
1ine(deltay  [#deltazl  ); 

c  i  pc  1  e  (di  r  f  cent  y  (fCentzl  )»' 
arc (di r* cent y  t  Kent  z)  ,  endy 


l,endzl ); 


endel e  ( )  * 

float  xinc/deltay  trdeltazl  ; 
float  centy  (»centzl rendy  Irendzl; 


DESCRIPTION: 


A  vector  relative  auto-increment  x  causes  the  initial 
x  coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  xinc.  With  every  mover  liner  arc 
or  circle  instruction  that  follows*  the  y  and  z  coor- 
dinate values  will'  be  updated,  while  x  is  stepped  by 
the  value  xinc.  For  example*  the  point(x*y»z)  becomes 
point (x  +  xinc/y  +  del tay^z+del taz)  . 

The  parameter  values  cannot  exceed  the  range  of  the 
defined  coordinate  system. 


DIAGNOSTICS 


All  error  messages  will  be  orinted  on  the  PDP-11 
mi  nal  sc  reen  . 


ter- 


Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E 1 3  -  Vector  type  undefined. 

Error  -  E14  -  The  increment  value  was  out  of 
bounds . 

Error  -  E16  -  The  y  value  was  out  of  bounds. 

Error  -  E17  -  The  z  value  was  out  of  bounds. 
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setvec«tor  -  VRY 


setvector  -  VRY 


NAME: 


VRY  -  vector  relative  auto-increment  y 


SYNOPSIS: 


drawele("elename")  r 


setvector(VRY,vmode*yinc) 
moveCdeltax  (rdeltazl  )? 
HneCdeltax  I,  delta?]  ); 
c i re  1 e (di r , cent x  [fcentzJ )> 
arc  (di  r,  cent  x  Ucentz)  »endx 


[,endzl ); 


endeleO; 

float  yincrdeltax  UdeltazJ  ; 
float  centx  ( , cent z)  > endx  [»endz) ; 


DESCRIPTION: 


A  vector  relative  auto-increment  y  causes  the  initial 
y  coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  yinc.  With  every  mover  liner  arc 
or  circle  instruction  that  follows*  the  x  and  z  coor- 
dinate values  will  be  uDdated*  while  y  is  stepoed  by 
the  value  yinc.  For  example*  the  point(xryrZ)  becomes 
point (x+del taxry+yincrZ+del taz) . 


The   parameter   values   cannot  exceed 
defined  coordinate  system. 


the  range  of  the 


DIAGNOSTICS: 


All  error  messages  will  be  printed  on  the  PDP-11 
mi  nal  sc  reen. 


ter- 


Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E13  -  Vector  type  undefined. 

Error  -  E14  -  The  increment  value  was  out  of 
bounds . 

Error  -  E15  -  The  x  value  was  out  of  bounds. 

Error  -  E17  -  The  z  value  was  out  of  bounds. 
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setvector  -  VRZ 


setvector  -  VRZ 


NAME: 


VRZ  -  vector  relative  auto-increment  z 


SYNOPSIS: 


draweleCelename")  ? 


setvectop(VRZ/vmode#zinc) 

moveCdeltax*  deltay)? 

Iine(de1tax  /deltay); 

ci  rcle(di  r/centx/centy); 

arc (di  PfCentx»centy;endx»endy); 


ende  1  e ( )  ; 

float  zi nc / del t ax , del t ay ? 
float  cent x r cent y r endx fendy; 


DESCRIPTION: 


A  vector  relative  auto-increment  z  causes  the  initial 
z  coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  zinc.  With  every  move*  line*  arc 
op  circle  instruction  that  follows*  the  x  and  y  coor- 
dinate values  will  be  updated/  while  z  is  stepped  by 
the  value  zinc.  Fop  example/  the  point(x/y/z)  becomes 
point (x+del t ax / y+del tay/Z+incz) . 

The  parameter  values  cannot  exceed  the  range  of  the 
defined  coordinate  system. 


DIAGNOSTICS: 


All  error  messages  will  be  printed  on  the  PDP-11 
minal  screen. 


ter- 


Error  -  E01  -  This  routine  has  been  called  outside 
of  a  draw  element  block. 

Error  -  E02  -  The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  -  E13  -  Vector  type  undefined. 

Error  -  E  1  4  -  The  increment  value  was  out  of 
bounds . 

Error  -  E15  -  The  x  value  was  out  of  bounds. 

Error  -  E16  -  The  y  value  was  out  of  bounds. 


Ill 


setvector  -  INC2 


setvector  -  INC2 


NAME: 


INC2  -  incremental  vector 


two  di  mens  i  ona 1 


SYNOPSIS: 


draweleCelename"); 


setvector(INC2,vmode»scale); 
move(de1 t ax  r del tay); 
line(deltax,deltay); 


endele( ) ; 

float  del  tax /del tay ; 

seal e: 

MG  -  add  the  coordinate  increments  to  the  7 

high  order  bits  of  the  specified  register. 
NMG-  add  the  coordinate  increments  to  the  7 

low  order  bits  of  the  specified  register. 


DESCRIPTION: 
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Arcs   and 
type. 


circles   cannot   be   drawn  with  this  vector 


DIAGNOSTICS: 


All  error  messages  will  be  orinted  on  the  PDP-11   ter- 
minal sc  reen . 


Error  -  E01  -  This  routine  has  been  called  outside 
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setvector  -  INC? 


setvector  -  INC2 


Error  -  E02  - 


Error 
Error 
Error 
Error 


E13 
E15 
E16 
E19 


of  a  draw  element  block. 

The  space  allocated  for  the  building 

of  elements  has  been  exceeded. 

Vector  type  undefined. 

The  x  value  was  out  of  bounds. 

The  y  value  was  out  of  bounds. 

Illegal  arc/circle  instruction 

from  an  incremental  vector. 
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setvector  -  INCX 


setvector  -  INCX 


NAME: 


INCX  -  incremental  vector  /two  dimensional 
auto-increment  x 


SYNOPSIS: 


draweleC'elename")? 


setvector(INCX,vmoderxinCfScale); 
move (del t ay / del tay) ? 
1 ineCdeltav/deltay); 


endel e ( ) ? 


f 1 oat  x  i  nc / del t ay ; 


seal e: 

MG  - 

NMG- 


add  the  coordinate  increments  to  the  7 

high  order  bits  of  the  specified  register 
add  the  coordinate  increments  to  the  7 
low  order  bits  of  the  specified  register. 


DESCRIPTION: 
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t.  T 
re 
and 
spec 

the 

or 
ermi 
MG) 


si  on 

i  rem 

sho 

Thi 

at  i  o 

he  v 

1  i  mi 

max  i 

i  f  i  e 
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This 
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This  incremental/  auto  increment  vector  causes  the  x 
coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  x i nc »  while  the  y  coordinate  value 
is  increment  by  small  relative  values. 


Arcs  and  circles  cannot 
type. 


be   drawn   with   this   vector 


1 1  a 


setvector  -  INCX 


setvector  -  INCX 


DIAGNOSTICS: 


AH   error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  -  E01  -  This  routine  has  been  called  outside 

of  a  draw  element  block. 
Error  -  E02  -  The  soace  allocated  for  the  building 

of  elements  has  been  exceeded. 
Error  -  E13  -  Vector  type  undefined. 
Error  -  E14  -  The  increment  value  was  out  of 

bounds . 
Error  -  E16  -  The  y  value  was  out  of  bounds. 
Error  -  E19  -  Illegal  arc/circle  instruction 

from  an  incremental  vector. 
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setvector  -  INCY 


setvector  -  INCY 


NAME: 


INCY  -  incremental  vector  ,two  dimensional 
auto-increment  y 


SYNOPSIS: 


drawele("e1enameM ) ? 


setvector(INCY,vmode,yinc, scale)? 
move(del t  ax , del tax) ; 
Iine(de1tax,de1tax); 


endel e ( ) ? 


f 1  oat  y i  nc , del t ax  ? 


seal e: 

MG  - 

NMG- 


add  the  coordinate  increments  to  the  7 

high  order  bits  of  the  specified  register 
add  the  coordinate  increments  to  the  7 
low  order  bits  of  the  specified  register. 


DESCRIPTION: 
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is  c  ri 
f  pom  a 
i  nc  rem 
t  i  ons 
mi  n  i  mu 
scaler 
added 
di  nate 
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This  incremental,  auto  increment  vector  causes  the  v 
coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  xinc,  while  the  y  coordinate  value 
is  increment  by  small  relative  values. 


Arcs  and  circles  cannot 
type. 


be   drawn   with   this   vector 


1  16 


setvector  -  INCY 


setvector  -  INCY 


DIAGNOSTICS: 


All   error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  -  E01  -  This  routine  has  been  called  outside 

of  a  draw  element  block. 
Error  -  E02  -  The  space  allocated  for  the  building 

of  elements  has  been  exceeded. 
Error  -  E13  -  Vector  type  undefined. 
Error  -  E14  -  The  increment  value  was  out  of 

bounds . 
Error  -  E15  -  The  x    value  was  out  of  bounds. 
Error  -  E19  -  Illegal  arc/circle  instruction 

from  an  incremental  vector. 
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setvector  -  INC3 


NAME: 


INC3  -  incremental  vector  /three  dimensional 


SYNOPSIS: 


drawele(Melename"); 


setvector(INCX,vmode*scale)? 
moveCdel tax  ,  del t  ay  r  del taz) ; 
1 i  ne (del t  ax , del t ay , del taz); 


endel e ( ) ; 


float  del t ax , del t ay , de 1 t az ; 


seal e: 

MG  - 

NMG- 


add  the  coordinate  increments  to  the  7 

high  order  bits  of  the  SDecified  register, 
add  the  coordinate  increments  to  the  7 
low  order  bits  of  the  specified  register. 


DESCRIPTION: 
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Arcs   and 
type. 


circles   cannot   be   drawn  with  this  vector 


DIAGNOSTICS: 


All  error  messaaes  will  be  printed  on  the  PDP-11 
mi  nal  sc  reen  . 


t  er- 
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setvector  -  INC3 


setvector  -  INC3 


Error  -  E01  - 


Error  -  E02  - 


Error 
Error 
Error 
Error 
Error 


E13 
E15 
E16 
E17 
E19 


This  routine  has  been  called  outside 

of  a  draw  element  block. 

The  SDace  allocated  for  the  building 

of  elements  has  been  exceeded. 

Vector  type  undefined. 

The  x  value  was  out  of  bounds. 

The  y  value  was  out  of  bounds. 

The  z  value  was  out  of  bounds. 

Illegal  arc/circle  instruction 

from  an  incremental  vector. 
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s  y  s  i  n  i  t 


sys  i  ni  t 


NAME: 


sysinit  -  vector  general  display  initialization 


SYNOPSIS: 

sysi  ni  t ( ) ; 


DESCRIPTION: 
This 


routine  establishes  a  link  with  the  vector  gen- 
eral »  initializes  its  display  system  and  sets  all  the 
user  default  carameters. 


This  routine  must  be  called  before  any 
i  nst  ruct  i  ons . 


other   display 


DIAGNOSTICS: 


If  the  initialization  cannot  be  properly  completed?  an 
error  message  will  be  printed  on  the  PDP-11  terminal 
and  the  process  will  be  terminated.  This  error  could 
occur  because  the  vector  general  is  being  accessed  by 
a  anot  her  user • 
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t  rans 


t  rans 


NAME: 


trans  -  translate  object 


SYNOPSIS: 

trans("objname"rX»y  [ ,  z )  )? 
f 1  oat  x ,y     [,  z)     ; 

DESCRIPTION: 

All  of  the  elements  associated  with  the  named  object 
are  translated  by  the  amount  x,  y,  z  at  display  time. 
Each  coordinate  point(X,Y,Z)  of  the  object  becomes 
poi nt (X  +  x t Yty , Z  +  z )  at  display  time. 

The  z  parameter  is  required  only  when  the  coordinate 
system  is  defined  as  three  dimensional*  and  will  be 
ignored  if  included. 

DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  -  E05  -  Unknown  object  name. 
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